文章目录
- 前言
- 一、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 = admin
role = "#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.git
95acef6..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
其中
mail.adminAddresses是管理员的邮件地址
mail.mailingLists 可以配置其他的邮件地址，用来接受邮件
配置完后，我们还需要配置仓库的hook
根据自身的情况来配置，这样我们在push的时候，就会收到邮件通知。
总结
Gitblit运行时对服务器性能要求不是很高，CPU和内存占用都很少。对于小公司来说，人员很少的情况下还是很实用，只是功能确实不是很多，而且有些地方操作起来还是不方便。
