自动化构建平台（一）Linux下搭建私有代码仓库Gitblit的安装和使用详解

文章目录

前言
一、Gitblit的安装和使用
- 1、本地安装
- 2、docker下安装
- 3、Gitblit使用简介
- 4、Gitblit仓库权限控制
- 5、Gitblit邮件配置
总结

前言

代码版本管理，git模式应该是目前最流行的代码管理软件。目前支持git的管理软件有很多。
Gitblit是一个小型的代码仓库管理软件，功能不是很多，优点是：小巧、CPU和内存占用比较少，对于小团队来说基本够用。Gitblit官网点击这里。

一、Gitblit的安装和使用

1、本地安装

进入官网，如下图，根据对应的系统选择合适的版本：
在这里插入图片描述
这里我们下载Linux下的最新版本：gitblit-1.9.3.tar.gz
解压：

tar -xzvf gitblit-1.9.3.tar.gz

进入目录查看文件信息：

mv gitblit-1.9.3 /opt/gitblit
cd /opt/gitblit
ls -alh

在这里插入图片描述

这里的一堆sh文件包含了启动、停止、安装服务等的操作，配置文件在data/defaults.properties里面，我们主要关心这几个配置：

server.contextPath
访问的根路径,可以不做修改，默认为/
server.httpPort
服务启动的端口，这里我们修改为：server.httpPort = 8083
server.shutdownPort
服务关闭端口，默认是8081，有需要的可以修改，因为8081比较常用
server.redirectToHttpsPort
是否强制跳转HTTPS，默认false

其他的配置大家可以自行查看说明进行配置。

另外gitblit需要在Java8上运行，如果电脑上装了多个jdk版本，我们可以修改gitblit.sh中的内容如下：

#!/bin/bash
#java -cp "gitblit.jar:ext/*" com.gitblit.GitBlitServer --baseFolder data/usr/java/jdk1.8.0_77/bin/java -cp "gitblit.jar:ext/*" com.gitblit.GitBlitServer --baseFolder data

将Java版本执行JDK8的目录，如果你的电脑本身就是jdk8可以不用修改

启动项目：

sh gitblit.sh

如果没什么错误，表示启动成功。

注意：

这里是前台启动，当我们关闭远程连接时，就会挂掉，Gitblit提供安装服务的脚本，我们将系统安装为系统脚本。根据自己的系统运行install-service-*.sh的文件即可。

Gitblit默认的安装路径是/opt/gitblit，在install-service-*.sh的文件里面也是使用绝对路径，如果你不是安装在/opt下面，将install文件的绝对路径改成你实际的路径

安装成功后，就可以使系统服务的命令来管理Gitblit了

比如我使用的是install-service-centos.sh，然后在系统里执行:

service gitblit status
Usage: /etc/init.d/gitblit {start|stop|restart|force-reload}

可以看出只支持：start|stop|restart|force-reload这几条指令，到此本地安装结束。

2、docker下安装

这里有一个坑，如果通过官方提供的docker镜像来安装，会有各种问题，通过搜索找到了其他的一些镜像没有问题。这里我们使用jacekkow/gitblit镜像，数据目录挂载到/usr/local/gitblit下面

docker run -d --name=gitblit \
-p 8083:8080 \
-p 8443:8443 \
-p 9418:9418 \
-p 29418:29418 \
-v /usr/local/gitblit:/opt/gitblit-data \
jacekkow/gitblit

然后我们访问：http://ip:8083如果正常，表示启动成功

3、Gitblit使用简介

安装成功后，我们访问http://ip:8083，界面如下所示：
在这里插入图片描述
默认用户名和密码，在【gitblit/data/users.conf】里面，我们查看文件

cat users.conf

如下所示：

[user "admin"]password = adminrole = "#admin"role = "#notfederated"

默认用户和密码都是admin/admin

登录成功后，下面我们创建一个仓库来演示如何使用
在这里插入图片描述
点击创建版本库

点击创建

然后点击仓库可查看详情

在这里插入图片描述
在这里可以查看仓库的链接地址，一般我们直接使用http协议，这里有个不友好的地方就是，快捷复制插件使用的是flash，但是目前大部分浏览器都禁用了flash，所以只能手动选择来复制了。

注意这里前面的admin是管理员，如果是发送给其他用户的，需要使用其他用户，比如有个test用户，那么clone地址应该是：

git clone http://test@192.168.101.170:8083/r/test.git

我们使用admin用户运行以下命令clone仓库：

git clone http://admin@192.168.101.170:8083/r/test.git

运行结果：

Cloning into 'test'...
remote: Counting objects: 4, done
remote: Finding sources: 100% (4/4)
remote: Getting sizes: 100% (3/3)
remote: Compressing objects: 100% (207/207)
remote: Total 4 (delta 0), reused 0 (delta 0)
Unpacking objects: 100% (4/4), done.

下面我们使用git命令来操作测试一下仓库提交

查看当前仓库的分支情况：

git branch

结果：

* master

切换到master

git checkout master

结果：

Already on 'master'
Your branch is up to date with 'origin/master'.

添加文件,我们先在目录下新建一个文件d.java，内容随便，然后添加到git

git add d.java

提交到本地

git commit -m "测试"

结果：

[master 6dcb4d7] 测试1 file changed, 1 insertion(+)create mode 100644 d.java

推送到远程仓库

git push

要求输入admin的密码，输入密码后提交成功

结果：

Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Delta compression using up to 16 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 306 bytes | 306.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote: Updating references: 100% (1/1)
To http://192.168.101.170:8083/r/test.git95acef6..6dcb4d7  master -> master

然后我们到管理后台查看提交记录：
在这里插入图片描述
文件以及提交成功。

4、Gitblit仓库权限控制

如果要限制仓库访问，可以根据这里的功能来创建用户或者团队等操作：
在这里插入图片描述
创建用户：

在这里插入图片描述
这里的用户管理逻辑很简单，团队和用户属于归属关系

给项目分配用户：
在这里插入图片描述
点击编辑：

通过这里来管理用户

5、Gitblit邮件配置

如果我们要在Gitblit中使用邮件，我们可以使用自己搭建的邮件服务来使用，如果想了解怎么搭建自己的私有邮件服务，可以参照我的文章：【Linux centos7下使用postfix/dovecot搭建自己的SMTP邮件服务器】，
在data/defaults.properties下进行配置：


# ip or hostname of smtp server
#
# SINCE 0.6.0
mail.server = mail.code-long.com# port to use for smtp requests
#
# SINCE 0.6.0
mail.port = 25# debug the mail executor
#
# SINCE 0.6.0
mail.debug = true# use SMTPs flag
mail.smtps = false# use STARTTLS flag
#
# SINCE 1.6.0
mail.starttls = false# if your smtp server requires authentication, supply the credentials here
#
# SINCE 0.6.0
mail.username =mail_admin
# SINCE 0.6.0
mail.password =AMXtRByuFNn4# from address for generated emails
#
# SINCE 0.6.0
mail.fromAddress = mail_admin@code-long.com# List of email addresses for the Gitblit administrators
#
# SPACE-DELIMITED
# SINCE 0.6.0
mail.adminAddresses = 123@qq.com# List of email addresses for sending push email notifications.
#
# This key currently requires use of the sendemail.groovy hook script.
# If you set sendemail.groovy in *groovy.postReceiveScripts* then email
# notifications for all repositories (regardless of access restrictions!)
# will be sent to these addresses.
#
# SPACE-DELIMITED
# SINCE 0.8.0
mail.mailingLists = 234@qq.com