Debian与GitLab数据迁移与同步技巧

一、数据迁移前的准备工作

版本一致性检查：确保新旧Debian服务器上的GitLab版本相同或兼容（如旧版本为16.2.4，新版本需≥16.2.4）。可通过cat /opt/gitlab/embedded/service/gitlab-rails/VERSION查看旧版本，新服务器安装时指定对应版本。
备份所有关键数据：包括仓库、数据库、配置文件、CI/CD配置、用户权限等，避免迁移过程中数据丢失。
测试环境验证：先在测试服务器上模拟迁移流程，确认步骤无误后再进行生产环境迁移。

创建备份：在旧服务器上执行sudo gitlab-rake gitlab:backup:create，默认生成备份文件存放在/var/opt/gitlab/backups/目录，文件名格式为时间戳_版本号_gitlab_backup.tar。
传输备份文件：通过scp命令将备份文件复制到新服务器的相同目录（需提前创建/var/opt/gitlab/backups/），例如：scp /var/opt/gitlab/backups/*.tar user@new-server:/var/opt/gitlab/backups/。
恢复备份：
- 新服务器上停止GitLab关键服务：sudo gitlab-ctl stop unicorn && sudo gitlab-ctl stop sidekiq && sudo gitlab-ctl stop nginx。
- 执行恢复命令（替换BACKUP为备份文件名中的时间戳部分）：sudo gitlab-rake gitlab:backup:restore BACKUP=2025-10-20-12-00-00。
- 恢复完成后重启服务：sudo gitlab-ctl start。

仓库数据：若只需迁移Git仓库，可停止GitLab服务后，使用rsync同步/var/opt/gitlab/repositories/目录到新服务器：sudo rsync -avz /var/opt/gitlab/repositories/ user@new-server:/var/opt/gitlab/repositories/。
配置与附件：同步配置文件/var/opt/gitlab/config/和共享目录/var/opt/gitlab/shared/，确保新服务器配置与旧服务器一致：sudo rsync -avz /var/opt/gitlab/config/ user@new-server:/var/opt/gitlab/config/；sudo rsync -avz /var/opt/gitlab/shared/ user@new-server:/var/opt/gitlab/shared/。

备份旧数据库：若GitLab使用PostgreSQL，执行sudo -u postgres pg_dump -d gitlabhq_production > gitlab-backup.sql备份数据库。
恢复新数据库：在新服务器上创建新数据库sudo -u postgres createdb gitlabhq_production_new，然后导入备份：sudo -u postgres psql gitlabhq_production_new < gitlab-backup.sql。
更新配置：修改新服务器/etc/gitlab/gitlab.rb中的数据库连接信息（如gitlab_rails['db_host']、gitlab_rails['db_name']），执行sudo gitlab-ctl reconfigure使配置生效。

功能验证：
- 访问新GitLab实例（http://新服务器IP），检查项目、用户、权限、CI/CD作业等是否正常。
- 创建测试项目、提交代码、发起合并请求，确认流程无异常。
同步技巧（可选）：rsync实时同步
- 若需保持新旧服务器数据同步（如迁移期间仍有数据写入旧服务器），可设置rsync定时任务。例如，每小时同步仓库目录：
```
# 在旧服务器上添加crontab任务
crontab -e
```
  输入：0 * * * * rsync -avz /var/opt/gitlab/repositories/ user@new-server:/var/opt/gitlab/repositories/。
配置一致性检查：
- 确保新服务器/etc/gitlab/gitlab.rb中的external_url、SSL证书、SSH端口等配置与旧服务器一致，避免访问问题。

0 赞

0 踩