跳到主要内容

GitLab 迁移与升级

3.8.1 迁移思路​

在生产场景中，升级通常伴随迁移（例如从本地机房迁移到云环境）。本质仍是“备份 + 还原”流程：

  1. 在原 GitLab 主机上备份配置文件和数据。
  2. 在目标主机安装相同版本的 GitLab。
  3. 在目标主机还原配置和数据。

说明：

  • 建议先做一次演练迁移，确认数据、权限、CI 任务都可正常工作。
  • 迁移过程可参考 GitLab 备份与恢复 文档中的命令步骤。

3.8.2 升级流程​

升级建议：

  • 新主机升级：先安装“原版本”并恢复数据，再做版本升级。
  • 版本升级不可跨大版本跳跃，建议按最近大版本路径逐级升级。

示例：

  • 若从 12.1 升级到 13.0，建议先升到 12.x 最新，再升到 13.0。

通用升级步骤：

  1. 下载目标版本安装包。
  2. 直接安装包升级（rpm/deb）。
  3. 若安装提示配置项过时，按提示修正 /etc/gitlab/gitlab.rb。
  4. 重新生成配置并重启服务。

常用命令：

gitlab-ctl reconfigure
gitlab-ctl restart

3.8.3 升级注意事项​

  • 升级前必须确认备份可用（配置文件 + 数据备份）。
  • 升级后重点验证：
    • Web 访问与登录
    • 仓库拉取/推送
    • CI/CD Runner 执行
    • 邮件通知与外部集成（LDAP/OAuth/Webhook）