windows 系统下 安装 gitblit 教程

2018-01-12 11:21:04来源:oschina作者:DrDong人点击

分享

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


本文笔者系统环境说明:

windows Server 2008 R2 数据中心版 64位
Java 8 JRE 32位 1. gitblit 服务配置

默认配置文件

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

如果需要使用其他配置文件,需要修改同目录下的配置引导文件内的 include 值

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

基本服务配置



设置仓库路径

该参数为必填内容

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

服务端口设置

重要,必须修改

#服务的标准 http 端口。<= 0禁用此连接器。
# 默认为 0
server.httpPort = 80;
#安全/ SSL https 端口服务。<= 0禁用此连接器。
# 默认 8443
server.httpsPort = 433
#重定向功能 http => https,默认为 关闭状态
server.redirectToHttpsPort = false
# 绑定IP,默认为空,监听所有IP地址的 http 端口
server.httpBindInterface =
# 绑定IP,默认为空,监听所有IP地址的 https 端口
server.httpsBindInterface =

启动Gitblit服务



手动启动

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

手动关闭

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

Giblit 服务随系统自动启动



注意事项

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

#服务添加脚本
{gitblit安装目录}/installService.cmd
#服务删除脚本
{gitblit安装目录}/uninstallService.cmd

编辑修改文件

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

#修改 默认 ARCH = amd64
#执行无效,修改为 x86
SET ARCH=x86
#新建变量,指定gitblit服务文件路径,下面是实例安装目录
SET CD = C:/git/gitblit
#修改该参数为空
--StartParams="" ^

添加至服务

笔者配置过程发现,由于某个问题,双击 服务添加脚本 虽然添加进系统服务,也会无法启动, 所以推荐,保险做法,通过 cmd 控制台,手动启动,添加服务脚本。

#打开文件所在目录
cmd >cd C:/git/gitblit
#执行安装脚本
cmd C:/git/gitblit > installService.cmd

检查服务状态



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

WX20180111-154558@2x


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

WX20180111-155050@2x




高级设置(常用)



开启用户认证,非公开可浏览模式

#默认是 false
web.authenticateViewPages = true

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

#默认是 false
web.enforceHttpBasicAuthentication = true

站点名称

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

链接生成

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

robots文件位置

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

邮件设置

# IP或SMTP服务器主机名
# 默认为空
mail.server = 127.0.0.1
# 端口设置 默认 25
mail.port = 25
#邮件认证模式 tls
#默认 false
mail.starttls = false
# 邮件服务器认证
mail.username =
mail.password =
#显示邮件发送地址
mail.fromAddress = noreply@example.com
# 管理员邮件名称
mail.adminAddresses = noreply@example.com

群发邮件通知

#发送推送电子邮件通知的电子邮件地址列表。
#这个键目前需要使用sendemail.groovy钩子脚本。
#如果您在groovy.postReceiveScripts中设置了sendemail.groovy,
#那么将所有存储库的电子邮件通知(不管访问限制!)
#发送到这些地址。
mail.mailingLists =

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

2. Gitblit Https SSL 证书修改

绑定证书

# 指定证书名称
# 默认名称 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

Https域证书修改

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

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

准备工作



确保当前已停止Gitblit服务;


Portecle 点击打开网址 :用于编辑证书文件,需要Java环境运行;


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


删除旧文件

#在证书目录下
{gitblit安装目录}/data/certs
#删除以下文件
{gitblit安装目录}/data/certs/ca.cer
{gitblit安装目录}/data/certs/caKeyStore.p12
{gitblit安装目录}/data/certs/caRevocationList.crl
#新文件会在Gitblit服务启动的时候,重新生成

域名证书格式转换



使用 Portecle 工具,编辑 214351170410809.pfx 域名证书:

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


动图实例(动图有点大,网卡请稍后,大小52MB) ScreenRecorderProject2

编辑gitblit证书库

使用 Portecle 工具,编辑 serverKeyStore.jks :

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


动图实例子 ScreenRecorderProject4

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

最新文章

123

最新摄影

微信扫一扫

第七城市微信公众平台