Debian GitLab如何进行数据迁移

Debian环境下GitLab数据迁移详细步骤

版本一致性检查：新旧服务器GitLab版本需一致或兼容（如旧版本为16.2.4，新版本建议安装相同版本），避免恢复数据时因版本差异导致错误。可通过cat /opt/gitlab/embedded/service/gitlab-rails/VERSION查看旧版本，新服务器安装时指定对应版本。
备份旧服务器数据：
- 完整备份：使用GitLab内置工具创建包含数据库、仓库、配置等的完整备份，命令：sudo gitlab-rake gitlab:backup:create。默认备份文件存放在/var/opt/gitlab/backups目录，文件名格式为时间戳_gitlab_backup.tar（如1725431200_2024_09_04_16.2.4_gitlab_backup.tar）。
- 单独备份关键文件：复制/etc/gitlab/gitlab.rb（配置文件）、/etc/gitlab/gitlab-secrets.json（密钥文件，含数据库密码等敏感信息）到本地或临时目录，避免迁移过程中遗漏。

安装GitLab：在新Debian服务器上安装与旧服务器相同版本的GitLab。以GitLab 16.2.4为例，步骤如下：
- 添加GitLab仓库：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash；
- 安装GitLab：sudo EXTERNAL_URL="http://新服务器IP" apt-get install gitlab-ce（替换为实际IP或域名）。
配置基础参数：编辑/etc/gitlab/gitlab.rb，至少设置EXTERNAL_URL（实例访问地址），如EXTERNAL_URL="http://192.168.2.200"，后续可根据需要调整其他参数（如邮件设置、SSL证书）。

传输备份文件到新服务器：使用scp命令将旧服务器备份文件（含gitlab-backup.tar、gitlab.rb、gitlab-secrets.json）复制到新服务器的/var/opt/gitlab/backups目录。例如：
scp /var/opt/gitlab/backups/1725431200_2024_09_04_16.2.4_gitlab_backup.tar root@新服务器IP:/var/opt/gitlab/backups/
scp /etc/gitlab/gitlab.rb root@新服务器IP:/etc/gitlab/
scp /etc/gitlab/gitlab-secrets.json root@新服务器IP:/etc/gitlab/。
恢复数据到新服务器：
- 设置备份文件权限：确保备份文件可读，命令：chmod 755 /var/opt/gitlab/backups/*.tar；
- 执行恢复命令：运行sudo gitlab-rake gitlab:backup:restore RAILS_ENV=production BACKUP=时间戳（时间戳需与备份文件名中的时间戳一致，如BACKUP=1725431200）。恢复过程中会提示“是否删除现有表”“是否重建authorized_keys文件”，均需输入yes确认。
恢复密钥与配置：将传输过来的gitlab-secrets.json复制到新服务器/etc/gitlab/目录，替换原有文件（若存在）；编辑/etc/gitlab/gitlab.rb，确保配置与旧服务器一致（如数据库连接、外部URL）。

重启GitLab服务：运行sudo gitlab-ctl restart，重启所有GitLab相关服务（unicorn、sidekiq、nginx等），使配置生效。
验证迁移结果：
- 访问新服务器GitLab实例（如http://新服务器IP），登录后检查项目、用户、权限、CI/CD配置等是否完整；
- 测试基本功能：创建新项目、提交代码、发起合并请求，确认数据一致性和功能可用性。

测试环境优先：生产环境迁移前，建议先在测试环境完成全流程验证，降低风险；
低峰时段操作：迁移过程可能影响服务可用性，建议选择业务低峰时段进行；
数据完整性检查：恢复后务必检查项目仓库、附件、数据库记录等是否完整，避免数据丢失；
权限修复：若恢复后出现权限问题，可检查/var/opt/gitlab/git-data/repositories目录归属（应为git:git），或通过GitLab控制台修复用户/组权限。

最新问答