ubuntu gitlab迁移与兼容性处理

一、迁移前准备

1. 版本一致性检查
   确保新旧服务器GitLab版本一致（可通过cat /opt/gitlab/embedded/service/gitlab-rails/VERSION查看版本号），避免因版本差异导致数据结构不兼容。

   • 若版本不一致，需先在新服务器安装与旧服务器相同的GitLab版本（参考使用旧版本包或通过Docker部署避免兼容性问题）。

2. 备份数据

   • 备份配置文件：/etc/gitlab/gitlab.rb、/etc/gitlab/gitlab-secrets.json。
   • 备份数据：执行sudo gitlab-rake gitlab:backup:create，备份文件存放在/var/opt/gitlab/backups/。

二、迁移操作步骤

1. 安装GitLab
   在新服务器安装与旧版本相同的GitLab：

   wget https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh  
   sudo bash script.deb.sh  
   sudo apt-get install gitlab-ce=[旧版本号]-ce.0_amd64.deb  
   

2. 恢复数据

   • 将备份文件复制到新服务器/var/opt/gitlab/backups/，并赋予权限：
     sudo chmod 777 *.tar。
   • 停止服务：sudo gitlab-ctl stop unicorn sidekiq。
   • 恢复数据：sudo gitlab-rake gitlab:backup:restore BACKUP=[备份文件名]，按提示输入yes。

3. 配置与重启

   • 替换配置文件：将备份的gitlab.rb和gitlab-secrets.json复制到/etc/gitlab/。
   • 重新配置并启动服务：
     sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart。

三、兼容性处理要点

1. 数据库兼容性

   • 若新旧服务器PostgreSQL版本差异较大，需手动迁移数据库（参考使用pg_dump/psql导出导入）。
   • 确保gitlab.rb中数据库连接参数（如host、port）正确。

2. 存储路径与附件

   • 若原服务器自定义了仓库存储路径（git_data_dir），需在新服务器gitlab.rb中同步配置，并复制仓库文件。
   • 迁移附件目录/var/opt/gitlab/shared/，确保文件权限正确。

3. 特殊组件处理

   • CI/CD Runner：需在新服务器重新注册Runner，或修改config.toml中的GitLab URL。
   • 对象存储：若使用外部存储（如S3），需在新服务器gitlab.rb中配置相同的访问密钥和参数。

四、验证与注意事项

1. 功能验证

   • 访问新服务器Web界面，检查项目、用户、权限是否正常。
   • 执行代码拉取/推送测试，确保仓库访问正常。

2. 风险控制

   • 迁移前确认新服务器磁盘空间充足，避免因空间不足导致失败。
   • 操作前备份所有数据，建议在低峰期执行，避免影响用户使用。

参考来源：