一、前言
GitLab是利用 Ruby on Rails 一个开源的版本管理系统,实现一个自托管的Git项目仓库,可通过Web界面进行访问公开的或者私人项目。
它拥有与Github类似的功能,能够浏览源代码,管理缺陷和注释。可以管理团队对仓库的访问,它非常易于浏览提交过的版本并提供一个文件历史库。
团队成员可以利用内置的简单聊天程序(Wall)进行交流。
它还提供一个代码片段收集功能可以轻松实现代码复用,便于日后有需要的时候进行查找。
Git的家族成员
-
Git:是一种版本控制系统,是一个命令,是一种工具。
-
Gitlib:是用于实现Git功能的开发库。
-
Github:是一个基于Git实现的在线代码托管仓库,包含一个网站界面,向互联网开放。
-
GitLab:是一个基于Git实现的在线代码仓库托管软件,你可以用gitlab自己搭建一个类似于Github一样的系统,一般用于在企业、学校等内部网络搭建git私服。
Gitlab的服务构成
-
Nginx:静态web服务器。
-
gitlab-shell:用于处理Git命令和修改authorized keys列表。
-
gitlab-workhorse:轻量级的反向代理服务器。
-
logrotate:日志文件管理工具。
-
postgresql:数据库。
-
redis:缓存数据库。
-
sidekiq:用于在后台执行队列任务(异步执行)。
-
unicorn:An HTTP server for Rack applications,GitLab Rails应用是托管在这个服务器上面的。
GitLab工作流程
GitLab Shell
GitLab Shell有两个作用:为GitLab处理Git命令、修改authorized keys列表。
当通过SSH访问GitLab Server时,GitLab Shell会:
限制执行预定义好的Git命令(git push, git pull, git annex)
调用GitLab Rails API 检查权限
执行pre-receive钩子(在GitLab企业版中叫做Git钩子)
执行你请求的动作 处理GitLab的post-receive动作
处理自定义的post-receive动作
当通过http(s)访问GitLab Server时,工作流程取决于你是从Git仓库拉取(pull)代码还是向git仓库推送(push)代码。
如果你是从Git仓库拉取(pull)代码,GitLab Rails应用会全权负责处理用户鉴权和执行Git命令的工作;
如果你是向Git仓库推送(push)代码,GitLab Rails应用既不会进行用户鉴权也不会执行Git命令,它会把以下工作交由GitLab Shell进行处理:
-
调用GitLab Rails API
-
检查权限执行pre-receive钩子(在GitLab企业版中叫做Git钩子)
-
执行你请求的动作
-
处理GitLab的post-receive动作
-
处理自定义的post-receive动作
GitLab Workhorse
GitLab Workhorse是一个敏捷的反向代理。它会处理一些大的HTTP请求,比如文件上传、文件下载、Git push/pull和Git包下载。其它请求会反向代理到GitLab Rails应用,即反向代理给后端的unicorn。
二、Gitlab安装
1.安装和配置必要的依赖关系
1
|
yum install -y curl policycoreutils-python openssh-server openssh-clients
|
2、添加Gitlab仓库
1
|
curl -sS https: //packages .gitlab.com /install/repositories/gitlab/gitlab-ce/script .rpm.sh | sudo bash
|
3、安装Gitlab
1
|
sudo EXTERNAL_URL= "http://git.wzlinux.com" yum install -y gitlab-ce
|
注:如果下载ce太慢,可以使用清华大学源:http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/
4、配置启动
1
|
gitlab-ctl reconfigure |
三、Gitlab管理
1、Gitlab备份
使用Gitlab一键安装包安装Gitlab非常简单, 同样的备份恢复与迁移也非常简单. 使用一条命令即可创建完整的Gitlab备份:
1
|
gitlab-rake gitlab:backup:create |
使用以上命令会在/var/opt/gitlab/backups目录下创建一个名称类似为1481598919_gitlab_backup.tar的压缩包, 这个压缩包就是Gitlab整个的完整部分, 其中开头的1481598919是备份创建的日期,
/etc/gitlab/gitlab.rb 配置文件须备份,
/var/opt/gitlab/nginx/conf nginx配置文件,
/etc/postfix/main.cfpostfix 邮件配置备份。
2、Gitlab恢复
Gitlab的从备份恢复也非常简单:
1
2
3
|
# 停止相关数据连接服务 gitlab-ctl stop unicorn gitlab-ctl stop sidekiq |
1
2
|
# 从1481598919编号备份中恢复 gitlab-rake gitlab:backup:restore BACKUP=1481598919 |
1
2
|
# 启动Gitlab sudo gitlab-ctl start
|
3、Gitlab自动备份
实现每天凌晨2点进行一次自动备份:通过crontab使用备份命令实现
1
|
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create
|
四、Gitlab的使用
Git global setup
1
2
|
git config --global user.name "wzlinux"
git config --global user.email "admin@wzlinux.com"
|
Create a new repository
1
2
3
4
5
6
|
git clone http: //git .wzlinux.com /ios/app1 .git
cd app1
touch README.md
git add README.md git commit -m "add README"
git push -u origin master |
Existing folder
1
2
3
4
5
|
cd existing_folder
git init git remote add origin http: //git .wzlinux.com /ios/app1 .git
git commit -m "Initial commit"
git push -u origin master |
Existing Git repository
1
2
3
4
|
cd existing_repo
git remote add origin http: //git .wzlinux.com /ios/app1 .git
git push -u origin --all git push -u origin --tags
|