如何在Linux中迁移GitLab的数据

一、迁移前准备

1. 版本兼容性检查：确保新旧服务器的GitLab版本一致（如原服务器为16.11.10，新服务器需安装相同版本），避免因版本差异导致数据冲突。
2. 备份原服务器数据：
   • 使用GitLab自带工具创建完整备份（包含仓库、数据库、用户/组信息、权限等）：sudo gitlab-rake gitlab:backup:create，默认备份文件存储在/var/opt/gitlab/backups/目录下。
   • 单独备份敏感配置文件（含数据库连接、加密密钥等重要信息）：sudo cp /etc/gitlab/gitlab.rb /var/opt/gitlab/backups/、sudo cp /etc/gitlab/gitlab-secrets.json /var/opt/gitlab/backups/。

二、数据迁移步骤

1. 传输备份文件到新服务器：使用scp命令将备份文件（含.tar备份文件、gitlab.rb、gitlab-secrets.json）从旧服务器复制到新服务器的/var/opt/gitlab/backups/目录（需提前创建该目录并设置正确权限，如sudo mkdir -p /var/opt/gitlab/backups/、sudo chown git:git /var/opt/gitlab/backups/）。
2. 新服务器安装GitLab：
   • 确保新服务器操作系统（如CentOS 8、Ubuntu 22.04）与原服务器一致，避免依赖冲突。
   • 按照GitLab官方文档安装与原服务器相同版本的GitLab（推荐使用Omnibus包安装，步骤简洁）：
     • Debian/Ubuntu：wget https://packages.gitlab.com/gitlab/gitlab-ce/packages/ubuntu/22.04/gitlab-ce_16.11.10-ce.0_amd64.deb && sudo dpkg -i gitlab-ce_16.11.10-ce.0_amd64.deb；
     • CentOS/RHEL：sudo yum install -y curl openssh-server postfix && curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash && sudo yum install -y gitlab-ce。
3. 恢复备份数据：
   • 停止GitLab相关服务（避免数据写入冲突）：sudo gitlab-ctl stop unicorn && sudo gitlab-ctl stop sidekiq。
   • 执行备份恢复命令（需替换BACKUP为备份文件的时间戳，如1725431200_2024_09_04_16.2.4）：sudo gitlab-rake gitlab:backup:restore BACKUP=1725431200_2024_09_04_16.2.4。
   • 恢复敏感配置文件：sudo cp /var/opt/gitlab/backups/gitlab.rb /etc/gitlab/gitlab.rb、sudo cp /var/opt/gitlab/backups/gitlab-secrets.json /etc/gitlab/gitlab-secrets.json。
4. 重新配置并启动GitLab：
   • 应用配置变更：sudo gitlab-ctl reconfigure（此命令会根据gitlab.rb更新服务配置）。
   • 启动GitLab服务：sudo gitlab-ctl start（启动unicorn、sidekiq、nginx等服务）。

三、迁移后验证

1. 服务状态检查：运行sudo gitlab-ctl status，确认所有服务（unicorn、sidekiq、nginx）均处于“run”状态。
2. 功能测试：
   • 访问GitLab Web界面（如http://新服务器IP），使用原管理员账号登录，检查项目列表、用户权限、CI/CD配置是否正常。
   • 克隆一个测试项目到本地，进行提交、推送、拉取操作，验证仓库功能是否正常。
3. 日志排查：若出现问题，查看GitLab日志定位原因（常用日志路径：/var/log/gitlab/下的unicorn.log、sidekiq.log、nginx/error.log）。