极狐 GitLab

迁移到新服务器

Tier: 基础版,专业版,旗舰版

Offering: 私有化部署

使用极狐GitLab 备份和恢复功能,将 Linux 软件包实例迁移到新服务器。您也可以选择 将 Linux 软件包极狐GitLab 实例迁移到 Docker。

如果您正在运行极狐GitLab Geo,另一种选择是 Geo 灾难恢复:计划内故障转移。在选择 Geo 进行迁移之前,您必须确保所有站点都满足 Geo 要求。

避免新服务器和旧服务器同时进行未经协调的数据处理,否则多个 服务器可能同时连接并处理相同的数据。例如,使用 接收邮件时,如果两个极狐GitLab 实例 同时处理邮件,那么两个实例都会丢失部分数据。 这类问题也可能出现在其他服务中,例如 非软件包安装的数据库、 非软件包安装的 Redis 实例,或非软件包安装的 Sidekiq。

先决条件:

  • 提前发布广播消息横幅,通知用户即将进行迁移。
  • 完整且最新的备份。创建完整的系统级备份,或 对迁移涉及的所有服务器创建快照,以防误执行破坏性命令 (如 rm)。
  • 管理员访问权限。

准备新服务器#

要准备新服务器:

  1. 从旧服务器复制 SSH 主机密钥, 以避免中间人攻击警告。 有关示例步骤,请参阅手动复制主站点的 SSH 主机密钥。

  2. 安装极狐GitLab。

  3. 将旧服务器上的 /etc/gitlab 文件复制到新服务器进行配置,并根据需要更新。 更多详情,请阅读 Linux 软件包安装的备份和恢复说明。

  4. 如适用,禁用接收邮件。

  5. 在备份和恢复后的首次启动时,阻止新的 CI/CD 作业启动。 编辑 /etc/gitlab/gitlab.rb 并设置以下内容:

    ruby
    nginx['custom_gitlab_server_config'] = "location = /api/v4/jobs/request {\n deny all;\n return 503;\n }\n"
  6. 重新配置极狐GitLab:

    shell
    sudo gitlab-ctl reconfigure
  7. 停止极狐GitLab,以避免任何潜在的不必要和意外的数据处理:

    shell
    sudo gitlab-ctl stop
  8. 停止 Redis:

    shell
    sudo gitlab-ctl stop redis
  9. 配置新服务器,使其能够接收 Redis 数据库和极狐GitLab 备份文件:

    shell
    sudo rm -f /var/opt/gitlab/redis/dump.rdb sudo chown <your-linux-username> /var/opt/gitlab/redis /var/opt/gitlab/backups

准备并传输旧服务器上的内容#

  1. 确保您拥有旧服务器的最新系统级备份或快照。

  2. 启用维护模式, 前提是您的极狐GitLab 版本支持。

  3. 阻止新的 CI/CD 作业启动:

    1. 编辑 /etc/gitlab/gitlab.rb,并设置以下内容:

      ruby
      nginx['custom_gitlab_server_config'] = "location = /api/v4/jobs/request {\n deny all;\n return 503;\n }\n"
    2. 重新配置极狐GitLab:

      shell
      sudo gitlab-ctl reconfigure
  4. 禁用周期性后台作业:

    1. 在右上角,选择管理员。
    2. 在左侧边栏中,选择监控 > 后台作业,以显示 Sidekiq 仪表板。
    3. 在 Sidekiq 仪表板的顶部菜单中,选择 Cron。
    4. 在 Sidekiq 仪表板的右上角,选择全部禁用。
  5. 等待正在运行的 CI/CD 作业完成,或接受未完成的作业可能丢失。 要查看所有正在运行的作业:

    1. 在左侧边栏中,选择 CI/CD > 作业。
    2. 在筛选栏中,选择状态 > 运行中。
  6. 等待 Sidekiq 作业完成:

    1. 在左侧边栏中,选择监控 > 后台作业。
    2. 在 Sidekiq 仪表板的顶部菜单中,选择队列。
    3. 在 Sidekiq 仪表板的右上角,选择实时轮询。 等待执行中和已进入队列降至 0。 这些队列包含用户提交的工作; 在这些作业完成前关闭可能导致工作丢失。 请记下 Sidekiq 仪表板中显示的数字,以便迁移后进行验证。
  7. 将 Redis 数据库刷新到磁盘,并停止极狐GitLab 中除迁移所需服务之外的其他服务:

    shell
    sudo /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
  8. 创建极狐GitLab 备份:

    shell
    sudo gitlab-backup create
  9. 备份完成后,禁用以下极狐GitLab 服务,并通过将以下内容添加到 /etc/gitlab/gitlab.rb 末尾来防止意外重启:

    ruby
    1alertmanager['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
  10. 重新配置极狐GitLab:

    shell
    sudo gitlab-ctl reconfigure
  11. 验证所有内容均已停止,并确认没有服务正在运行:

    shell
    sudo gitlab-ctl status
  12. 将 Redis 数据库和极狐GitLab 备份传输到新服务器:

    shell
    sudo 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 等工具或挂载卷快照,将数据移动到新环境。

在新服务器上恢复数据#

  1. 恢复适当的文件系统权限:

    shell
    sudo 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
  2. 启动 Redis:

    shell
    sudo gitlab-ctl start redis

    Redis 会自动读取并恢复 dump.rdb。

  3. 恢复极狐GitLab 备份。

  4. 验证 Redis 数据库是否正确恢复:

    1. 在右上角,选择管理员。
    2. 在左侧边栏中,选择监控 > 后台作业。
    3. 在 Sidekiq 仪表板下,验证数字 是否与旧服务器上显示的数字一致。
    4. 仍在 Sidekiq 仪表板下,选择 Cron,然后选择全部启用, 以重新启用周期性后台作业。
  5. 测试极狐GitLab 实例上的只读操作是否按预期工作。例如,浏览项目代码仓库文件、合并请求和议题。

  6. 如果之前已启用,请禁用维护模式。

  7. 测试极狐GitLab 实例是否按预期工作。

  8. 如适用,重新启用接收邮件,并测试其是否按预期工作。

  9. 更新您的 DNS 或负载均衡器,使其指向新服务器。

  10. 通过移除之前添加的自定义 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"
  11. 重新配置极狐GitLab:

    shell
    sudo gitlab-ctl reconfigure
  12. 移除计划维护的广播消息横幅。