Gitlab使用国内镜像安装、备份及迁移

一、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