版权： 凌云物网智科实验室< www.iot-yun.com >声明： 本文档由凌云物网智科实验室郭工编著！作者： 郭文学< QQ: 281143292 [email protected]> 版本： 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-jdk2.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.sh2.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/gitblit2.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 单个文件大小限制为200M2.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 密码: admin3.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 servletfederation.passphrase must be non-emptyThe 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 = 472c159489febfb4fa15dcaadbeb5da15151496efederation.IGKv1.frequency = 5 minsfederation.IGKv1.folder = federation.IGKv1.bare = truefederation.IGKv1.mirror = truefederation.IGKv1.exclude = * federation.IGKv1.include = IGKv1.git配置好后重启gitblit服务：guowenxue@ubuntu-master:/opt/gitblit$ sudo service gitblit restart5分钟之后，我们可以在gitblit路径下看到腾讯云服务器上的仓库已经同步过来！guowenxue@ubuntu-master:/opt/gitblit$ ls data/git/IGKv1.git/在浏览器后台上访问家里的gitblit服务器，也可以看到相应的项目文件了：