版权： 凌云物网智科实验室< www.iot-yun.com >

声明： 本文档由凌云物网智科实验室郭工编著！

作者： 郭文学< QQ: 281143292 guowenxue@gmail.com>

版本： v1.0.0

一. gitblit介绍

作为一个合格的程序员，版本控制系统的重要性不言而喻。而作为程序员界的“扛把子”，Linus Torvalds 大神因忍受不了BitKeeper的诸多限制，为方便管理 Linux 内核源码而设计了更为灵活的版本控制系统git。起初 Git 的开发也只是为了辅助 Linux 内核开发，但很快越来越多的自由软件项目和公司在软件开发中都使用git了。本人从业十多年来，使用的版本控制系统也历经了CVS->SVN->Git的变迁，最近几年自己负责的所有项目源码也都改成git托管了。

现在有许多免费的代码托管网站，如国外的github、国内的gitee等。其中github因国内访问慢的“尿性”而广受诟病，另外在这些网站上免费托管代码必须开源，而私有git仓库则需要收费。这样，如果有一些商业项目代码再在上面托管就不合时宜了，自己搭建一个git服务器才是王道。

在选择git服务器时，备受推崇的莫过于著名的gitlab了，它是一个利用Ruby on Rails开发的开源应用程序，实现一个自托管的Git项目仓库，可通过Web界面进行访问公开的或者私人项目。最开始也尝试在自己的服务器上使用gitlab搭建git服务器，但Ruby毕竟是脚本语言，CPU和内存那是消耗得杠杠的，性能不行的服务器实在经不起折腾！

后来历经千山万水，终于找到了今天的主角--gitblit，一个java实现的轻量级的git服务器。gitblit的安装和使用都非常简单，当然最重要的一点是是它的速度要比gitlab快、快、快很多，作为一个小团队的项目管理绰绰有余。另外，我最喜欢他的另外一个特性--federation功能，该功能可以直接同步另外一台主机上的gitblit仓库，这样不同服务器主机之间git仓库可以镜像备份了。

本文将详细讲解ubuntu Linux下gitblit的安装和使用，测试环境为腾讯云 Ubuntu-18.04 Linux服务器。gitblit跨平台支持Windows和Linux，最新版本下载请到官方站点:

http://gitblit.github.io/gitblit/

二. gitblit安装

2.1 安装jdk环境

因为gitblit是使用Java开发的，所以Java开发环境必须搭建好：

guowenxue@VM-0-12-ubuntu:~$ sudo apt-get update
guowenxue@VM-0-12-ubuntu:~$ sudo apt-get install default-jre default-jdk

2.2 下载安装gitblit

从gitblit官网上下载最新的Linux发行版本，当前最新的为 gitblit-1.9.1，解压安装到/opt路径下：

guowenxue@VM-0-12-ubuntu:~$ sudo tar -xzf gitblit-1.9.1.tar.gz -C /opt/
guowenxue@VM-0-12-ubuntu:~$ cd /opt/
guowenxue@VM-0-12-ubuntu:/opt$ sudo mv gitblit-1.9.1/ gitblit
guowenxue@VM-0-12-ubuntu:/opt$ cd gitblit/
guowenxue@VM-0-12-ubuntu:/opt/gitblit$ ls

add-indexed-branch.sh  docs         gitblit.sh                 install-service-fedora.sh  LICENSE             reindex-tickets.sh
authority.sh           ext          gitblit-stop.sh            install-service-ubuntu.sh  migrate-tickets.sh  service-centos.sh
data                   gitblit.jar  install-service-centos.sh  java-proxy-config.sh       NOTICE              service-ubuntu.sh

2.3 创建gitblit用户并更改所有者

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo useradd gitblit
guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo chown -R gitblit:gitblit /opt/gitblit

2.4 修改配置服务端口

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo vim data/defaults.properties

git.sshPort = 8882            修改SSH端口 8882
server.httpPort = 8888        修改HTTP端口8888
server.httpsPort = 0          禁用HTTPs端口
git.packedGitLimit = 200m     单个文件大小限制为200M

2.5 安装并启动服务

安装相关服务：

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo ./install-service-ubuntu.sh

启动gitblit服务：

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo service gitblit restart

启动需要一些时间，可以使用netstat命令查看gitblit是否正常运行并监听相应端口：

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo netstat -tlnp | grep java

如果服务启动异常，可以查看gitblit服务的日志文件：

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo tail  /opt/gitblit/data/logs/gitblit.log

三. gitblit使用

3.1 web后台登录

Web浏览器上输入自己Ubuntu主机公网IP地址和相应端口即可访问gitblit服务后台, 如： http://122.51.234.174:8888/ 默认管理员用户名: admin 密码: admin

3.2 帐号管理

出于安全性考虑，使用管理员帐号登录后，我们应该到用户中心创建新的管理员帐号，并删除默认的admin帐号。

在用户管理页面我们可以创建新的管理员帐号，管理员帐号也可以设置是否允许创建仓库：

当然我们也可以在这里给团队内其他人创建普通帐号

出于安全考虑，删除默认帐号admin:

3.3 仓库管理

gitblit上创建仓库也很简单，在“版本库”菜单下点击“创建版本库”就开始创建项目仓库：

如下图所示，我们创建了一个IGKv1的项目，这是凌云实验室打算出的一款ARM Linux物联网网关开发板，我们设置所有人都可以访问、克隆该仓库源码，但只有授权的用户才能提交代码。

仓库创建好后，点击进入该项目我们如下图可以获取仓库的克隆下载地址：

gitblit上的相关仓库文件都将存放到 gitblit 安装路径的 data/git下，一个仓库对应一个文件夹，如下图所示的 IGKv1.git。

创建好项目后，我们可以点击进入到该项目下，点击右侧的“编辑”按钮来管理该项目权限：

在“permisssions”菜单中，我们可以将负责该项目开发的帐号添加进去，这样这些账户就能够提交代码了。

如果不想要这个仓库，我们也可以在该页面中删除：

四. gitblit federation

gitblit对我来说还有一个比较实用的功能就是federation，该机制可以在不同的服务器之间同步备份，这点对于源码安全来说太重要了！譬如我的项目源码会在 阿里云新加坡服务器或腾讯云服务器 与 家里的Linux服务器之间同步，这样一个服务器奔溃也不会导致数据丢失。

关于federation功能的说明可以参考官方 说明( http://gitblit.com/federation.html)，下面是功能的描述和使用说明，就不翻译了。

A Gitblit federation is a mechanism to clone repositories and keep them in sync from one Gitblit instance to another. Federation can be used to maintain a mirror of your Gitblit instance, to aggregate repositories from developer workstations, or to initially clone groups of repositories to developer workstations. If you are/were a Subversion user you might think of this as svn-sync, but better.

Origin Gitblit Instance Requirements：

git.enableGitServlet must be true, all Git clone and pull requests are handled through Gitblit's JGit servlet

federation.passphrase must be non-empty

The Gitblit origin instance must be http/https accessible by the pulling Gitblit instance.

That may require configuring port-forwarding on your router and/or opening ports on your firewall.

下面是在我家里的Linux服务器上定时自动同步腾讯云服务器上仓库的详细过程：

腾讯云Ubuntu服务器上gitblit federation操作：

首先在腾讯云服务器上配置gitblit使能 federation:

guowenxue@VM-0-12-ubuntu:~$ cd /opt/gitblit/
guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo vim data/defaults.properties

git.enableGitServlet = true
federation.passphrase = mypassword     设置同步的密码

接下来关闭并重启gitblit服务器，我们从服务器的启动日志中可以找到相应的Federation Token，这个Token一会同步时会用到：

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo service gitblit stop
guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo rm -f data/logs/gitblit.log
guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo service gitblit start
guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo vim data/logs/gitblit.log

家里Ubuntu服务器上gitblit同步操作：

guowenxue@ubuntu-master:~$ cd /opt/gitblit
guowenxue@ubuntu-master:/opt/gitblit$ sudo vim data/defaults.properties

... ...

federation.allowProposals = true 首先使能federation

... ...

#federation.example1.url = https://go.gitblit.com

#federation.example1.token = 6f3b8a24bf970f17289b234284c94f43eb42f0e4

#federation.example1.frequency = 120 mins

#federation.example1.folder =

#federation.example1.bare = true

#federation.example1.mirror = true

#federation.example1.mergeAccounts = true

# 找到上面这些行，在下面添加腾讯云服务器上的gitblit同步

# 下面这个配置将5分钟同步一次腾讯云服务器 gitblit 下的所有仓库

#federation.tencent.url = http://122.51.234.174:8888/

#federation.tencent.token = 472c159489febfb4fa15dcaadbeb5da15151496e

#federation.tencent.frequency = 5 mins

#federation.tencent.folder =

#federation.tencent.bare = true

#federation.tencent.mirror = true

#federation.tencent.mergeAccounts = true

# 下面这个配置将5分钟同步一次腾讯云服务器 gitblit 下的IGKv1项目仓库

federation.IGKv1.url = http://122.51.234.174:8888/

federation.IGKv1.token = 472c159489febfb4fa15dcaadbeb5da15151496e

federation.IGKv1.frequency = 5 mins

federation.IGKv1.folder =

federation.IGKv1.bare = true

federation.IGKv1.mirror = true

federation.IGKv1.exclude = *

federation.IGKv1.include = IGKv1.git

配置好后重启gitblit服务：

guowenxue@ubuntu-master:/opt/gitblit$ sudo service gitblit restart

5分钟之后，我们可以在gitblit路径下看到腾讯云服务器上的仓库已经同步过来！

guowenxue@ubuntu-master:/opt/gitblit$ ls data/git/IGKv1.git/

在浏览器后台上访问家里的gitblit服务器，也可以看到相应的项目文件了：