版权: 凌云物网智科实验室< 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 updateguowenxue@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/ gitblitguowenxue@VM-0-12-ubuntu:/opt$ cd gitblit/guowenxue@VM-0-12-ubuntu:/opt/gitblit$ lsadd-indexed-branch.sh  docs         gitblit.sh                 install-service-fedora.sh  LICENSE             reindex-tickets.shauthority.sh           ext          gitblit-stop.sh            install-service-ubuntu.sh  migrate-tickets.sh  service-centos.shdata                   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 gitblitguowenxue@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.propertiesgit.sshPort = 8882            修改SSH端口 8882server.httpPort = 8888        修改HTTP端口8888server.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
b4bbb3bae4964000800591227c0faaa0

如果服务启动异常,可以查看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

dc1ecf7df4d145cbba2aeb4e7943d3db

3.2 帐号管理

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

47cadc4145ff41f7a57d11d6c387645a

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

07bb30c3e0d248328006fb596b8233a7

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

ecd2ed08ef17460cbb3d68d2a2140174

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

cab1a7000ee94f6c80dee514d73304f6

3.3 仓库管理

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

4240c7fdde5a417e9303a9e0f7d048af

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

a45b3e78aec942e5ad1971e1c4c01d0e

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

d843bbc3d18e43559af1a70c48f9eaf0

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

d73b431e40bc460e8ea4d582f83d1909

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

9b114df17cfd4f8ea4589daf7d4c3ed0

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

0b2606dc918d45af90f7faa9b5032cd2

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

962c68ebba80407384063f07d9d3438e

四. 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.

2714e84535a0445c9790a5aebee6e53a

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.propertiesgit.enableGitServlet = truefederation.passphrase = mypassword     设置同步的密码

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

guowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo service gitblit stopguowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo rm -f data/logs/gitblit.logguowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo service gitblit startguowenxue@VM-0-12-ubuntu:/opt/gitblit$ sudo vim data/logs/gitblit.log
b13e1165a40b4c16b5fd3e9db52d5293

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

guowenxue@ubuntu-master:~$ cd /opt/gitblitguowenxue@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/
a252c5415fb14db2b15496380946dcf9

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

c1c39dcceff14dc3874d1c3b5f19729c
Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐