CentOS上GitLab的数据迁移方法

CentOS上GitLab数据迁移详细步骤

一、迁移前准备工作

1. 确认版本兼容性：确保目标GitLab实例版本与源实例版本一致或更高（避免跨大版本迁移导致数据结构不兼容）。
2. 安装必要依赖：在目标服务器上安装GitLab运行所需的依赖包，确保存储、网络服务正常：

   yum install -y policycoreutils openssh-server openssh-clients postfix
   systemctl enable sshd && systemctl start sshd
   systemctl enable postfix && systemctl start postfix
   

3. 备份源服务器数据：使用GitLab内置工具创建完整备份，包含代码仓库、数据库、用户信息、配置文件等：

   # GitLab 12.1及以上版本
   gitlab-backup create
   # GitLab 12.1及以下版本
   gitlab-rake gitlab:backup:create
   

   默认备份文件存储在/var/opt/gitlab/backups目录，文件名为时间戳_版本号_gitlab_backup.tar（如1715000000_16.0.0_gitlab_backup.tar）。

二、传输备份文件至目标服务器

使用scp命令将备份文件从源服务器复制到目标服务器的相同备份目录（需提前创建/var/opt/gitlab/backups并设置git用户所有权）：

scp root@源服务器IP:/var/opt/gitlab/backups/*.tar root@目标服务器IP:/var/opt/gitlab/backups/

三、目标服务器恢复数据

1. 停止相关服务：为保证数据一致性，停止GitLab的unicorn（Web服务）和sidekiq（后台任务）进程：

   sudo gitlab-ctl stop unicorn
   sudo gitlab-ctl stop sidekiq
   

2. 恢复备份文件：执行恢复命令，指定备份文件的时间戳前缀（如1715000000）：

   sudo gitlab-backup restore BACKUP=1715000000
   

   恢复过程会覆盖现有数据库和仓库数据，需确认操作。
3. 恢复配置文件：将源服务器的gitlab.rb（GitLab主配置）和gitlab-secrets.json（敏感信息，如数据库密码、SMTP密钥）复制到目标服务器的/etc/gitlab/目录：

   scp root@源服务器IP:/etc/gitlab/gitlab.rb root@目标服务器IP:/etc/gitlab/
   scp root@源服务器IP:/etc/gitlab/gitlab-secrets.json root@目标服务器IP:/etc/gitlab/
   

四、配置与启动目标GitLab

1. 重新配置GitLab：运行reconfigure命令使配置文件生效，更新数据库连接、SSH端口等信息：

   sudo gitlab-ctl reconfigure
   

2. 启动GitLab服务：启动所有GitLab组件并设置开机自启：

   sudo gitlab-ctl start
   sudo gitlab-ctl enable
   

五、验证迁移结果

1. 访问Web界面：通过浏览器访问目标服务器的external_url（如http://目标服务器IP），确认能正常登录。
2. 检查数据完整性：
   • 验证用户账号、权限是否与源服务器一致；
   • 检查项目仓库是否能正常克隆、推送；
   • 查看CI/CD配置、问题跟踪、合并请求等功能是否正常。
3. 查看日志排查问题：若出现异常，检查GitLab日志定位错误（日志路径：/var/log/gitlab/）：

   tail -f /var/log/gitlab/gitlab-rails/production.log
   

注意事项

• 备份文件安全：备份文件包含敏感信息，传输和存储时需加密（如使用scp而非FTP），避免泄露。
• 版本匹配：若源服务器版本较旧，建议先升级到目标版本再进行迁移，减少兼容性问题。
• 测试迁移：建议先在非生产环境测试迁移流程，确保数据无误后再应用于正式环境。