windows 系统下 安装 gitblit 教程

时间  2019-11-15
标签 windows 系统 安装 gitblit 教程 栏目 Windows 繁體版
原文   原文链接

Gitblit官方网站
本文实例版本号：1.8
下载完毕后，解压至任意位置。html

本文笔者系统环境说明：java

  1. windows Server 2008 R2 数据中心版 64位
  2. Java 8 JRE 32位

1. gitblit 服务配置

默认配置文件

{gitblit安装目录}\data\defaults.properties

若是须要使用其余配置文件，须要修改同目录下的配置引导文件内的 include 值

{gitblit安装目录}\data\gitblit.properties
#值为你新建的配置文件
include = my.properties

基本服务配置

1. 设置仓库路径

该参数为必填内容 git

#自定义仓库目录
git.repositoriesFolder = C:/git/GitRepository

2. 服务端口设置

重要，必须修改，文档内的参数：_请填写实际搭建的服务器IP，域名，端口_web

#服务的标准 http 端口。<= 0禁用此链接器。
# 默认为 0
server.httpPort = <端口号>;
    
#安全/ SSL https 端口服务。<= 0禁用此链接器。
# 默认 8443
server.httpsPort = <端口号>
    
#重定向功能 http => https,默认为 关闭状态
server.redirectToHttpsPort = false
    
# 绑定IP，默认为空，监听全部IP地址的 http 端口
server.httpBindInterface = <ip/或者不填>
    
# 绑定IP，默认为空，监听全部IP地址的 https 端口
server.httpsBindInterface = <ip/或者不填>

SSH端口redis

#默认监听 ssh 端口 29418
git.sshPort = <端口号>
    
#填写IP 默认为空
git.sshBindInterface = <ip/或者不填>
    
#填写域名 默认为空
git.sshAdvertisedHost = <域名>
    
#填写IP 默认为空
git.sshAdvertisedPort = <ip/或者不填>

3. 启动Gitblit服务

  1. 手动启动数据库

    # 双击执行，成功执行文件，并无自动关闭，说明成功运行Gitblit服务
{gitblit安装目录}\gitblit.cmd

  2. 手动关闭windows

    # 也能够点击关闭 启动的 cmd 窗口 服务即终止
# 或者双击执行，自动关闭启动的 cmd 窗口
{gitblit安装目录}\gitblit-stop.cmd

4. Giblit 服务随系统自动启动

  1. 注意事项安全

    Gitblit(1.8版本)，自动启动须要修改，自带的服务添加文件服务器

    #服务添加脚本
{gitblit安装目录}\installService.cmd

#服务删除脚本
{gitblit安装目录}\uninstallService.cmd

  2. 编辑修改文件oracle

    选择 服务添加脚本 -> 右键选择 编辑

    #修改 默认 ARCH = amd64
#执行无效，修改成 x86
SET ARCH=x86

#新建变量,指定gitblit服务文件路径,下面是实例安装目录 如：C:\git\gitblit
SET CD = <gitblit安装目录>

#修改该参数为空
--StartParams="" ^

  3. 添加至服务

    笔者配置过程发现，因为某个问题，双击 服务添加脚本 虽然添加进系统服务，也会没法启动， 因此推荐，保险作法，经过 cmd 控制台，手动启动，添加服务脚本。

    #打开文件所在目录 如：C:\git\gitblit
cmd >cd <gitblit安装目录>

#执行安装脚本 输入 installService.cmd
cmd C:\git\gitblit > installService.cmd

  4. 检查服务状态

    1. 打开任务管理器，查看 gitblit 服务是否正在运行

      WX20180111-154558@2x

    2. 运行 {gitblit安装目录}\gitblitw.exe 测试，手动 开启，关闭，是否正常。

      WX20180111-155050@2x

5. 高级设置（经常使用）

  1. 全局属性

    # 新存储库的默认访问限制。
# 有效值为NONE，PUSH，CLONE，VIEW 
# NONE = 匿名视图，克隆和推
# PUSH = 匿名视图＆克隆和验证推
# CLONE = 匿名视图，验证克隆和推
# VIEW = 验证视图，克隆，按
git.defaultAccessRestriction = PUSH

#新存储库的默认受权控制。
#有效值进行身份验证，并命名为
#AUTHENTICATED =任何身份验证的用户授予限制访问
#NAMED =只有指定的用户/团队被授予限制访问
git.defaultAuthorizationControl = NAMED

  2. 开启用户认证，非公开可浏览模式

    #默认是 false
web.authenticateViewPages = true

  3. 使用windows基本认证，必须非公开模式下生效

    #默认是 false 
web.enforceHttpBasicAuthentication = true

  4. 站点名称

    # 默认空白 官方说明：If blank Gitblit is displayed.
web.siteName = git

  5. 连接生成 

    #使用自定义端口时须要填写 如 非80 443 默认为 空
#此URL的主机名将被提取用于SSH和GIT协议存储库
# e.g. web.canonicalUrl = https://dev.gitblit.com
#      web.canonicalUrl = https://dev.gitblit.com:8443
web.canonicalUrl = https://<域名>
#填写正确的域名

  6. 工单服务，【默认没有开启】

    # 设置工单数据存储方式 三选一
# 一：.git目录下的文件系统中
# com.gitblit.tickets.FileTicketService
# 二：独立的分支上 这使您能够轻松地将整个故障单历史记录复制到客户端工做副本或镜像。
# com.gitblit.tickets.BranchTicketService
# 三：Redis数据库服务
# com.gitblit.tickets.RedisTicketService
tickets.service = com.gitblit.tickets.BranchTicketService
    # Redis数据库服务 选择使用 redis 数据库
tickets.redis.url = redis://(:{password}@){hostname}:{port}(/{databaseId})

tickets.redis.url = redis://localhost:6379
tickets.redis.url = redis://:password@localhost:6379/2

  7. robots文件位置

    #搜索引擎机器人的道德文件
#默认位置 {安装目录}\data\robots.txt
web.robots.txt = ${baseFolder}/robots.txt

  8. 联合注册

    # 向非管理员用户显示联合注册（无令牌）和当前的状态
web.showFederationRegistrations = false 

# 这是web.authenticateViewPages = true 时显示的消息
# 这能够指向一个包含Markdown内容的文件。
# 指定“gitblit”使用内部登陆消息。
web.loginMessage = gitblit

  9. 时区

    # 修改最后修改时间格式
web.datetimestampLongFormat = yyyy-MM-dd HH:mm:ss, EEEE

  10. 邮件设置

    # IP或SMTP服务器主机名
# 默认为空 不启用
mail.server = <IP或SMTP服务器主机名>

# 端口设置 默认 25
mail.port = <端口>

#邮件认证模式 tls
#默认 false
mail.starttls = false

# 邮件服务器认证
mail.username = <帐号>
mail.password = <密码>

#显示邮件发送地址 收件人显示的，发送人邮箱
mail.fromAddress = noreply@example.com

# 管理员邮件名称 管理员邮箱
mail.adminAddresses = noreply@example.com

  11. 群发邮件通知

    #发送推送电子邮件通知的电子邮件地址列表。
#这个键目前须要使用sendemail.groovy钩子脚本。
#若是您在groovy.postReceiveScripts中设置了sendemail.groovy，
#那么将全部存储库的电子邮件通知（无论访问限制！）
#发送到这些地址。
mail.mailingLists =

6. 更多设置请查看配置文件与官方文档说明

2. Gitblit Https SSL 证书修改

1. 绑定证书

# 指定证书名称 
# 默认名称 localhost
server.certificateAlias = localhost
    
# 证书库密码与证书密码必须一致 方便管理
# 默认密码 gitblit
    
#若是您使用的是来自Oracle的官方JRE或JDK,
#则您的JVM 可能没有 JCE Unlimited Strength Jurisdiction 策略文件。
#由于这个，你的存储/密钥密码不能超过7个字符。若是你须要的话
#您可能须要更长的密码才能
#从Oracle 安装 JCE Unlimited Strength Jurisdiction 策略文件。
    
server.storePassword = gitblit

JCE Unlimited Strength Jurisdiction 策略文件 从 Oracle 官网下载

#将政策文件，解压至 Java 安装目录内的下面路径文件夹便可
{java安装目录}\lib\security

2. Https域证书修改

关于ssl证书，gitblit 启动时，会根据配置文件去检测一些文件，若是没有所需文件，将会根据配置文件进行生成。其中就包括证书库文件，位置以下：

{gitblit安装目录}\data\serverKeyStore.jks

  1. 准备工做

    1. 确保当前已中止Gitblit服务；

    2. Portecle 点击打开网址 :用于编辑证书文件，须要Java环境运行;

    3. 有效的域名证书，证书必须包含证书与私钥，以 214351170410809.pfx 为例子;

    4. 删除旧文件

      #在证书目录下
{gitblit安装目录}\data\certs

#删除如下文件
{gitblit安装目录}\data\certs\ca.cer
{gitblit安装目录}\data\certs\caKeyStore.p12
{gitblit安装目录}\data\certs\caRevocationList.crl

#新文件会在Gitblit服务启动的时候，从新生成

  2. 域名证书格式转换

    1. 使用 Portecle 工具，编辑 214351170410809.pfx 域名证书：

      1. 双击运行 Portecle.jar =>能够直接将证书拖入对话框内->输入证书密码->选择证书->右键选择导出->选择类型为：证书与私钥；格式为：PKCS#12->输入新的证书密码，或者旧密码保持密码不变->选择导出目录->导出完成

      2. 视频实例,(密码：yxwl001)

        点击观看视频

    2. 编辑gitblit证书库

      1. 使用 Portecle 工具，编辑 serverKeyStore.jks ：

        1. 双击运行 Portecle.jar => 直接将文件拖入对话框->输入证书库密码->选中默认证书->右键选择删除->点击导入->选择刚才导出的证书->输入证书密码->查看证书信息->填写证书名称->确认证书密码->导入完成提示->点击保存当前文件

        2. 视频实例,(密码：yxwl002)

          点击观看视频

    3. 成功保存后，启动Gitblit服务，成功启动说明成功替换证书。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程