ubuntu与gitlab数据迁移方法

Ubuntu与GitLab数据迁移方法

一、准备工作

1. 版本一致性检查：迁移前需确保源服务器与目标服务器的GitLab版本完全一致（包括CE/EE类型）。可通过cat /opt/gitlab/embedded/service/gitlab-rails/VERSION查看源版本，目标服务器安装对应版本（如gitlab-ce_14.8.2-ce.0_amd64.deb），避免因版本差异导致恢复失败。
2. 备份现有数据：无论源服务器是否为Ubuntu，均需通过GitLab原生工具创建完整备份，包含仓库、用户、CI/CD配置等核心数据。命令：sudo gitlab-rake gitlab:backup:create，默认生成路径为/var/opt/gitlab/backups。
3. 目标环境准备：在Ubuntu目标服务器上安装与源版本一致的GitLab（推荐使用Omnibus包，步骤见下文“安装新实例”）。

二、安装新GitLab实例（Ubuntu目标服务器）

1. 添加GitLab软件源：导入GPG密钥并添加APT源，确保软件包来源可信。

   curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
   echo "deb https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab.list
   sudo apt-get update
   

2. 安装GitLab CE：通过APT安装社区版GitLab，后续可通过apt upgrade保持更新。

   sudo apt-get install gitlab-ce
   

3. 基础配置：修改/etc/gitlab/gitlab.rb设置外部访问URL（如external_url 'http://your-server-ip:8090'），然后执行sudo gitlab-ctl reconfigure使配置生效。
4. 启动服务：启动GitLab并设置开机自启：sudo gitlab-ctl start。

三、数据迁移（核心步骤）

1. 备份文件传输

将源服务器/var/opt/gitlab/backups目录下的备份文件（如1684461274_2023_05_19_13.12.2_gitlab_backup.tar）复制到目标服务器相同路径。可使用scp命令（需替换IP和路径）：

scp -r user@source-server-ip:/var/opt/gitlab/backups/* user@target-server-ip:/var/opt/gitlab/backups/

2. 恢复数据

1. 设置备份文件权限：目标服务器上进入备份目录，赋予备份文件可执行权限：

   cd /var/opt/gitlab/backups
   chmod 777 1684461274_2023_05_19_13.12.2_gitlab_backup.tar  # 替换为实际文件名
   

2. 停止相关服务：停止GitLab的数据连接服务，避免恢复冲突：

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

3. 执行恢复：使用gitlab-rake命令恢复指定备份文件（注意：BACKUP参数为文件名前缀，不含.tar后缀）：

   sudo gitlab-rake gitlab:backup:restore BACKUP=1684461274_2023_05_19_13.12.2
   

4. 启动服务：恢复完成后重启GitLab服务：

   sudo gitlab-ctl start
   

四、迁移后验证

1. 访问测试：通过浏览器访问目标服务器的external_url（如http://your-server-ip:8090），使用原GitLab的管理员账号（如root）登录，确认能正常访问。
2. 数据核对：检查项目仓库（能否正常克隆/拉取）、用户信息（账号权限是否一致）、CI/CD配置（流水线能否触发）、Wiki/上传文件等内容是否完整。
3. 功能测试：运行一个简单的CI/CD pipeline（如gitlab-ci.yml中的test阶段），验证自动化流程是否正常；检查Runner是否可用（需重新注册Runner，若原Runner未迁移）。

五、常见问题解决

1. PostgreSQL扩展错误：恢复时若出现ERROR: must be owner of extension pg_trgm等提示，可忽略（官方文档说明此为正常现象，不影响数据完整性）。
2. Runner令牌失效：迁移后原Runner无法使用，需在目标服务器的GitLab项目页面重新注册Runner（路径：Settings > CI/CD > Runners）。
3. 项目导入限制：若使用GitLab Export/Import功能（非备份恢复），需注意：仅支持导出项目仓库、wiki、上传文件等基础数据，CI/CD变量、Webhook等敏感信息需手动重新配置；且不同版本间可能存在兼容性问题（如GitLab 13.0+可导入前两个小版本的导出文件）。