一、Gitlab 安装
1. 环境准备
本教程主要以 CentOS 7为主,其他系统请查看官方文档对比。
1. 安装和打开 http 和 ssh 的权限
sudo yum install -y curl policycoreutils-python openssh-server sudo systemctl enable sshd sudo systemctl start sshd sudo firewall-cmd --permanent --add-service=http sudo systemctl reload firewalld
2. 安装邮件服务 postfix
sudo yum install postfix sudo systemctl enable postfix sudo systemctl start postfix
使用其他邮件服务,可以根据官方文档自行修改:
https://docs.gitlab.com/omnibus/settings/smtp.html
2. 镜像切换
Gitlab 国外镜像速度一向感人,而且是不是的还抽风,所以在国内搭建 Gitlab 使用的时候,还是切换成墙内镜像比较放心。目前官方支持的国内镜像是清华大学的镜像站,地址:https://mirror.tuna.tsinghua.edu.cn/help/gitlab-ce/
1. 新建镜像 repo
新建 /etc/yum.repos.d/gitlab-ce.repo
,内容为:
[gitlab-ce] name=Gitlab CE Repository baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/ gpgcheck=0 enabled=1
2. 执行命令下载
sudo yum makecache sudo yum install gitlab-ce
3. 配置使用
安装完成之后,可以在/etc/gitblab/gitlab.rb
中按照需求修改配置,
主要需要修改external_url
,改成自己使用的 url 地址。
执行命令配置生效:
gitlab-ctl reconfigure
如果想使用已有的 nginx,或者相对 gitlab 内置 nginx 进行高级配置的话,可以参考官方文档:
https://docs.gitlab.com/omnibus/settings/nginx.html
例如,修改监听端口,增加 ssl 配置,设置 header:
nginx['listen_port'] = 8081 # For GitLab nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt" nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key" # proxy set header nginx['proxy_set_headers'] = { "X-Forwarded-Proto" => "http", "CUSTOM_HEADER" => "VALUE" }
需要注意的是,修改配置之后,都需要执行gitlab-ctl reconfigure
命令,使配置生效。
二、Gitlab 备份
Gitlab 成功运行起来之后,最终的事情就是定期的备份,遇到问题后的还原。
1. 备份配置
默认 Gitlab 的备份文件会创建在/var/opt/gitlab/backups
文件夹中,格式为时间戳_日期_版本号_gitlab_backup.tar
,例如:1515031353_2018_01_04_10.3.2_gitlab_backup.tar
。
修改备份文件夹,需要修改配置文件/etc/gitlab/gitlab.rb
中的:
gitlab_rails['backup_path'] = '/your_wish/backups'
然后gitlabctl-reconfigure
生效。
2. 手动备份
命令:gitlab-rake gitlab:backup:create
会在命令执行的时间点,在你配置的文件夹或者默认文件夹创建一个备份文件。
3. 自动备份
Gitlab 支持 crontab
来创建计划任务,执行命令:sudo crontab -e -u root
,为 root 用户,创建并编辑 crontab。
例如,每周二到周六的早晨创建一个自己命名规则的备份:
15 04 * * 2-6 umask 0077; tar cfz /secret/gitlab/backups/$(date "+etc-gitlab-\%s.tgz") -C / etc/gitlab
crontab 可以参考:
http://www.pantz.org/software/cron/croninfo.html
更多备份用法,可以参考:
https://docs.gitlab.com/omnibus/settings/backups.html#backups
4. 恢复备份
先停止 gitlab 相关服务:
sudo gitlab-ctl stop unicorn sudo gitlab-ctl stop sidekiq
执行备份恢复命令:
gitlab-rake gitlab:backup:restore BACKUP=1515031353_2018_01_04_10.3.2
为了防止有问题,还是需要执行重新配置,用来重新配置和启动:
gitlab-ctl reconfigure
5. 迁移,及版本不一致问题
Gitlab 迁移
Gitlab 的迁移非常简单,只需要在目标服务器上安装好之后,把 Gitlab 的备份文件放到备份目录中,然后执行上一步的恢复备份命令即可。
Gitlab 迁移版本不一致问题
但是Gitlab 有个不爽的地方就是,不同版本号的备份文件不能相互使用。有时候备份文件是旧版本,安装的时候自动安装了最新版本,这时候备份文件就没办法使用了,怎么办呢?
- 先卸载掉已经安装的最新版Gitlab:
sudo yum remove gitlab-ce
- 在 Gitlab package 地址https://packages.gitlab.com/gitlab/gitlab-ce中找到对应操作系统和版本的安装包,例如 CentOS 7,Gitlab 10.3.1对应的是gitlab-ce-10.3.1-ce.0.el7.x86_64.rpm
执行安装命令
curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash sudo yum install gitlab-ce-10.3.1-ce.0.el7.x86_64
然后重复之前的安装、配置、恢复备份的目录即可。