迁移到新服务器
Tier: 基础版,专业版,旗舰版
Offering: 私有化部署
使用极狐GitLab 备份和恢复功能,将 Linux 软件包实例迁移到新服务器。您也可以选择 将 Linux 软件包极狐GitLab 实例迁移到 Docker。
如果您正在运行极狐GitLab Geo,另一种选择是 Geo 灾难恢复:计划内故障转移。在选择 Geo 进行迁移之前,您必须确保所有站点都满足 Geo 要求。
避免新服务器和旧服务器同时进行未经协调的数据处理,否则多个 服务器可能同时连接并处理相同的数据。例如,使用 接收邮件时,如果两个极狐GitLab 实例 同时处理邮件,那么两个实例都会丢失部分数据。 这类问题也可能出现在其他服务中,例如 非软件包安装的数据库、 非软件包安装的 Redis 实例,或非软件包安装的 Sidekiq。
先决条件:
- 提前发布广播消息横幅,通知用户即将进行迁移。
- 完整且最新的备份。创建完整的系统级备份,或 对迁移涉及的所有服务器创建快照,以防误执行破坏性命令 (如 rm)。
- 管理员访问权限。
准备新服务器
要准备新服务器:
-
从旧服务器复制 SSH 主机密钥, 以避免中间人攻击警告。 有关示例步骤,请参阅手动复制主站点的 SSH 主机密钥。
-
将旧服务器上的 /etc/gitlab 文件复制到新服务器进行配置,并根据需要更新。 更多详情,请阅读 Linux 软件包安装的备份和恢复说明。
-
如适用,禁用接收邮件。
-
在备份和恢复后的首次启动时,阻止新的 CI/CD 作业启动。 编辑 /etc/gitlab/gitlab.rb 并设置以下内容:
rubynginx['custom_gitlab_server_config'] = "location = /api/v4/jobs/request {\n deny all;\n return 503;\n }\n" -
重新配置极狐GitLab:
shellsudo gitlab-ctl reconfigure -
停止极狐GitLab,以避免任何潜在的不必要和意外的数据处理:
shellsudo gitlab-ctl stop -
停止 Redis:
shellsudo gitlab-ctl stop redis -
配置新服务器,使其能够接收 Redis 数据库和极狐GitLab 备份文件:
shellsudo rm -f /var/opt/gitlab/redis/dump.rdb sudo chown <your-linux-username> /var/opt/gitlab/redis /var/opt/gitlab/backups
准备并传输旧服务器上的内容
-
确保您拥有旧服务器的最新系统级备份或快照。
-
启用维护模式, 前提是您的极狐GitLab 版本支持。
-
阻止新的 CI/CD 作业启动:
-
编辑 /etc/gitlab/gitlab.rb,并设置以下内容:
rubynginx['custom_gitlab_server_config'] = "location = /api/v4/jobs/request {\n deny all;\n return 503;\n }\n" -
重新配置极狐GitLab:
shellsudo gitlab-ctl reconfigure
-
-
禁用周期性后台作业:
- 在右上角,选择管理员。
- 在左侧边栏中,选择监控 > 后台作业,以显示 Sidekiq 仪表板。
- 在 Sidekiq 仪表板的顶部菜单中,选择 Cron。
- 在 Sidekiq 仪表板的右上角,选择全部禁用。
-
等待正在运行的 CI/CD 作业完成,或接受未完成的作业可能丢失。 要查看所有正在运行的作业:
- 在左侧边栏中,选择 CI/CD > 作业。
- 在筛选栏中,选择状态 > 运行中。
-
等待 Sidekiq 作业完成:
- 在左侧边栏中,选择监控 > 后台作业。
- 在 Sidekiq 仪表板的顶部菜单中,选择队列。
- 在 Sidekiq 仪表板的右上角,选择实时轮询。 等待执行中和已进入队列降至 0。 这些队列包含用户提交的工作; 在这些作业完成前关闭可能导致工作丢失。 请记下 Sidekiq 仪表板中显示的数字,以便迁移后进行验证。
-
将 Redis 数据库刷新到磁盘,并停止极狐GitLab 中除迁移所需服务之外的其他服务:
shellsudo /opt/gitlab/embedded/bin/redis-cli -s /var/opt/gitlab/redis/redis.socket save && \ sudo gitlab-ctl stop && \ sudo gitlab-ctl start postgresql && \ sudo gitlab-ctl start gitaly -
创建极狐GitLab 备份:
shellsudo gitlab-backup create -
备份完成后,禁用以下极狐GitLab 服务,并通过将以下内容添加到 /etc/gitlab/gitlab.rb 末尾来防止意外重启:
ruby1alertmanager['enable'] = false 2gitaly['enable'] = false 3gitlab_exporter['enable'] = false 4gitlab_kas['enable'] = false 5gitlab_pages['enable'] = false 6gitlab_workhorse['enable'] = false 7logrotate['enable'] = false 8gitlab_rails['incoming_email_enabled'] = false 9nginx['enable'] = false 10node_exporter['enable'] = false 11postgres_exporter['enable'] = false 12postgresql['enable'] = false 13prometheus['enable'] = false 14puma['enable'] = false 15redis['enable'] = false 16redis_exporter['enable'] = false 17registry['enable'] = false 18sidekiq['enable'] = false -
重新配置极狐GitLab:
shellsudo gitlab-ctl reconfigure -
验证所有内容均已停止,并确认没有服务正在运行:
shellsudo gitlab-ctl status -
将 Redis 数据库和极狐GitLab 备份传输到新服务器:
shellsudo scp /var/opt/gitlab/redis/dump.rdb <your-linux-username>@new-server:/var/opt/gitlab/redis sudo scp /var/opt/gitlab/backups/your-backup.tar <your-linux-username>@new-server:/var/opt/gitlab/backups
适用于 Git 和对象数据量较大的实例
如果您的极狐GitLab 实例在本地卷上存储了大量数据(例如超过 1 TB),备份可能需要很长时间。在这种情况下,将数据传输到新实例的相应卷上可能更简单。
您可能需要手动迁移的主要卷包括:
- /var/opt/gitlab/git-data 目录,其中包含所有 Git 数据。请务必阅读 移动代码仓库文档章节, 以消除 Git 数据损坏的可能性。
- /var/opt/gitlab/gitlab-rails/shared 目录,其中包含对象数据,例如产物。
- /var/opt/gitlab/gitlab-rails/uploads 目录,其中包含上传数据,例如用户头像。
- 如果您使用的是 Linux 软件包内置的 PostgreSQL, 您还需要迁移位于 /var/opt/gitlab/postgresql/data 下的 PostgreSQL 数据目录。
停止所有极狐GitLab 服务后,您可以使用 rsync 等工具或挂载卷快照,将数据移动到新环境。
在新服务器上恢复数据
-
恢复适当的文件系统权限:
shellsudo chown gitlab-redis /var/opt/gitlab/redis sudo chown gitlab-redis:gitlab-redis /var/opt/gitlab/redis/dump.rdb sudo chown git:root /var/opt/gitlab/backups sudo chown git:git /var/opt/gitlab/backups/your-backup.tar -
启动 Redis:
shellsudo gitlab-ctl start redisRedis 会自动读取并恢复 dump.rdb。
-
验证 Redis 数据库是否正确恢复:
- 在右上角,选择管理员。
- 在左侧边栏中,选择监控 > 后台作业。
- 在 Sidekiq 仪表板下,验证数字 是否与旧服务器上显示的数字一致。
- 仍在 Sidekiq 仪表板下,选择 Cron,然后选择全部启用, 以重新启用周期性后台作业。
-
测试极狐GitLab 实例上的只读操作是否按预期工作。例如,浏览项目代码仓库文件、合并请求和议题。
-
如果之前已启用,请禁用维护模式。
-
测试极狐GitLab 实例是否按预期工作。
-
如适用,重新启用接收邮件,并测试其是否按预期工作。
-
更新您的 DNS 或负载均衡器,使其指向新服务器。
-
通过移除之前添加的自定义 NGINX 配置,解除对新 CI/CD 作业启动的阻止:
ruby# The following line must be removed nginx['custom_gitlab_server_config'] = "location = /api/v4/jobs/request {\n deny all;\n return 503;\n }\n" -
重新配置极狐GitLab:
shellsudo gitlab-ctl reconfigure -
移除计划维护的广播消息横幅。