Debian与GitLab的数据迁移方法

Debian环境下GitLab数据迁移的常见方法

1. 使用GitLab内置备份与恢复工具（推荐）

这是最常用的迁移方式，适用于完整迁移GitLab实例（包括仓库、用户、CI/CD配置、附件等）。

• 备份现有数据：在旧服务器上执行sudo gitlab-rake gitlab:backup:create，生成备份文件（默认存放在/var/opt/gitlab/backups/目录，文件名格式为时间戳_版本号_gitlab_backup.tar）。
• 传输备份文件：使用scp或rsync将备份文件复制到新服务器的/var/opt/gitlab/backups/目录（需提前创建该目录并赋予777权限）。
• 准备新服务器：在新Debian服务器上安装与旧服务器版本一致的GitLab（通过curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash添加仓库，再用apt install gitlab-ce安装）。
• 恢复数据：
  ① 停止GitLab关键服务：sudo gitlab-ctl stop unicorn && sudo gitlab-ctl stop sidekiq（防止数据冲突）；
  ② 执行恢复命令：sudo gitlab-rake gitlab:backup:restore BACKUP=时间戳（替换为备份文件名中的时间戳）；
  ③ 恢复配置文件：将旧服务器的/etc/gitlab/gitlab.rb和/etc/gitlab/gitlab-secrets.json复制到新服务器对应位置（gitlab-secrets.json包含加密密钥，必须同步）。
• 重新配置与启动：运行sudo gitlab-ctl reconfigure应用新配置，再用sudo gitlab-ctl start启动所有服务。
• 验证结果：通过浏览器访问新服务器的GitLab地址（external_url需在gitlab.rb中设置），检查用户、仓库、CI/CD作业等是否正常。

2. 使用rsync迁移Git仓库（快速迁移仓库数据）

若仅需迁移Git仓库（不包含用户、配置等），可使用rsync直接同步仓库目录，适合增量迁移或仓库单独迁移。

• 停止GitLab服务：sudo gitlab-ctl stop unicorn && sudo gitlab-ctl stop sidekiq（确保数据一致性）。
• 同步仓库目录：使用rsync -avz /var/opt/gitlab/repositories/ user@新服务器IP:/var/opt/gitlab/repositories/（-a保留权限，-v显示进度，-z压缩传输）。
• 配置新服务器：安装GitLab后，编辑/etc/gitlab/gitlab.rb，更新external_url为新服务器地址，运行sudo gitlab-ctl reconfigure。
• 启动服务并验证：sudo gitlab-ctl start，检查仓库是否能正常克隆、推送。

3. 分步迁移数据库与附件（精细控制）

若需单独迁移数据库或附件（如大型数据库、自定义附件），可采用分步方式，适合定制化迁移。

• 迁移数据库：
  ① 停止GitLab服务（同上）；
  ② 备份数据库（以PostgreSQL为例）：sudo -u postgres pg_dump -d gitlabhq_production > gitlab-backup.sql；
  ③ 传输备份文件到新服务器：scp gitlab-backup.sql user@新服务器IP:/tmp/；
  ④ 恢复数据库：在新服务器上创建数据库sudo -u postgres createdb gitlabhq_production，再导入数据sudo -u postgres psql gitlabhq_production < /tmp/gitlab-backup.sql。
• 迁移附件与配置：使用rsync同步/var/opt/gitlab/config/（配置文件）、/var/opt/gitlab/shared/（附件、日志等）目录到新服务器。
• 更新配置与启动：修改gitlab.rb中的数据库连接信息（如gitlab_rails['db_host']、gitlab_rails['db_password']），运行sudo gitlab-ctl reconfigure，最后启动服务。

4. 使用专门迁移工具（批量迁移复杂数据）

若需迁移大量项目、用户权限、合并请求等复杂数据，可使用第三方工具（如GitLab官方推荐的gitlab-migrator或社区工具），简化批量迁移流程。

• 工具选择：优先选择支持GitLab API的工具（如gitlab-migrator），确保兼容新旧版本。
• 操作步骤：参考工具文档配置源服务器与目标服务器的连接信息，执行迁移命令（如gitlab-migrator migrate --source http://旧服务器IP --target http://新服务器IP），工具会自动同步项目、用户、权限等数据。
• 注意事项：迁移前需测试工具兼容性，确保新旧服务器版本匹配（如工具支持GitLab 16.x迁移至17.x）。

迁移前的关键注意事项

• 版本兼容性：新旧服务器的GitLab版本需一致或兼容（如旧版本为16.x，新版本可为16.x或17.x，但不建议跨大版本迁移）。
• 备份数据：迁移前务必备份所有重要数据（仓库、数据库、配置文件），防止迁移失败导致数据丢失。
• 测试环境验证：先在测试服务器上模拟迁移流程，确认无误后再进行生产环境迁移。
• 权限检查：迁移后需检查用户、项目权限是否正常（如管理员权限、项目访问权限）。