GitLab 迁移指南

在进行 GitLab 迁移之前，确保新旧服务器上的 GitLab 版本一致。

查看当前 GitLab 版本

cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
# 显示为 10.3.3

1. 新服务器系统升级

先升级内核和软件：

yum -y update

升级完成后查看系统版本号：

cat /etc/redhat-release
# 输出：CentOS Linux release 7.6

2. 在新服务器上安装 GitLab

请参阅安装教程。

3. 升级旧服务器上的 GitLab

GitLab 不能跨版本升级，需逐个大版本升级。例如，从 10.3.3 升级到 12.0.1，需经过以下步骤：

yum install -y gitlab-ce-10.8.7-ce.0.el7
yum install -y gitlab-ce-11.11.0-ce.0.el7
yum install -y gitlab-ce

注：如果不指定版本号，则会自动升级到最新版本。

每次升级后，都要测试 GitLab 后台系统是否正常。如果不能访问，则说明升级失败，应解决错误或回退版本。

4. 拷贝旧服务器的备份文件到新服务器

4.1 备份旧服务器的文件

gitlab-rake gitlab:backup:create

备份文件将默认生成在 /var/opt/gitlab/backups/ 目录下。

4.2 使用 scp 命令从旧服务器复制文件到新服务器

scp /var/opt/gitlab/backups/1561597102_2019_06_27_12.0.1_gitlab_backup.tar [email protected]:/var/opt/gitlab/backups/

根据提示输入新服务器的密码。

5. 在新服务器上恢复 GitLab

5.1 修改备份文件权限，避免权限不足的问题

cd /var/opt/gitlab/backups
chmod 777 1561597102_2019_06_27_12.0.1_gitlab_backup.tar

5.2 停止数据连接服务

gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq

5.3 恢复备份文件到 GitLab

gitlab-rake gitlab:backup:restore BACKUP=备份文件编号

例如：备份文件名为 1561597102_2019_06_27_12.0.1_gitlab_backup.tar，则编号为 1561597102_2019_06_27_12.0.1。在提示中输入“yes”继续。

5.4 启动 GitLab

gitlab-ctl start

最后检查新旧 GitLab 的内容是否完全一致，迁移成功！