ubuntu下gitlab如何迁移

Ubuntu下GitLab迁移步骤指南

1. 迁移前准备

• 确认版本兼容性：迁移前需确保新旧服务器的GitLab版本一致（如均为15.0.0），避免因版本差异导致数据损坏。可通过cat /opt/gitlab/embedded/service/gitlab-rails/VERSION（Omnibus安装）或gitlab-rake gitlab:env:info查看版本。
• 检查系统资源：新服务器需满足GitLab的硬件要求（如CPU≥2核、内存≥4GB、存储≥100GB），并预留足够空间存放备份文件。

2. 备份旧服务器数据

使用GitLab内置的gitlab-rake工具创建完整备份，包含仓库、用户、CI/CD配置、数据库等所有数据：

sudo gitlab-rake gitlab:backup:create

默认备份文件存储在/var/opt/gitlab/backups目录，文件名格式为时间戳_版本_gitlab_backup.tar（如1715472000_15.0.0_gitlab_backup.tar）。可通过ls -l /var/opt/gitlab/backups确认备份文件是否存在。

3. 安装新服务器GitLab实例

在目标Ubuntu服务器上通过Omnibus包（推荐）安装GitLab，步骤如下：

• 导入GitLab仓库密钥：

  curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
  

• 添加GitLab软件源：

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

• 更新包索引并安装GitLab CE：

  sudo apt-get update
  sudo apt-get install gitlab-ce
  

• 配置基础参数：编辑/etc/gitlab/gitlab.rb，设置外部访问URL（如external_url 'http://新服务器IP'），保存后重新加载配置：

  sudo gitlab-ctl reconfigure
  

• 启动GitLab服务：

  sudo gitlab-ctl start
  

• 验证安装：浏览器访问http://新服务器IP，首次登录需修改默认密码。

4. 迁移备份文件到新服务器

将旧服务器的备份文件复制到新服务器的/var/opt/gitlab/backups目录（需确保目录权限为gitlab-www:gitlab-www）：

# 旧服务器执行（替换user/new_server为新服务器用户名/IP）
scp -r /var/opt/gitlab/backups/* user@new_server:/var/opt/gitlab/backups/

# 新服务器确认备份文件权限（可选）
sudo chown -R gitlab-www:gitlab-www /var/opt/gitlab/backups

若备份文件较大，可使用rsync替代scp提高传输效率。

5. 恢复数据到新服务器

• 停止相关服务：为保证数据一致性，停止GitLab的unicorn（应用服务器）和sidekiq（后台任务处理器）：

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

• 执行恢复命令：

  sudo gitlab-rake gitlab:backup:restore BACKUP=时间戳
  

  其中时间戳为备份文件的前缀（如1715472000对应1715472000_15.0.0_gitlab_backup.tar）。恢复过程会提示“是否覆盖现有数据”，输入yes确认。
• 恢复配置文件（可选）：若旧服务器有自定义配置（如gitlab.rb、SSL证书），需将其复制到新服务器对应目录：

  sudo cp /path/to/old/gitlab.rb /etc/gitlab/gitlab.rb
  sudo cp -r /path/to/old/ssl /etc/gitlab/ssl
  sudo gitlab-ctl reconfigure  # 重新加载配置
  

6. 启动新服务器GitLab服务

恢复完成后，启动GitLab所有服务并检查状态：

sudo gitlab-ctl start
sudo gitlab-ctl status  # 确认所有服务均为“run”状态

若服务未正常启动，可通过sudo gitlab-ctl tail查看日志排查问题。

7. 验证迁移结果

• 访问Web界面：浏览器访问新服务器的external_url（如http://新服务器IP），确认能正常登录。
• 检查数据完整性：
  • 进入“项目”页面，确认所有仓库均存在；
  • 进入“用户”页面，确认所有用户及权限正确；
  • 查看“CI/CD”→“流水线”，确认历史流水线记录未丢失；
  • 检查“Wiki”“Issues”等附加功能是否正常。

注意事项

• 版本一致性：迁移前后GitLab版本必须相同，否则恢复会失败；若需升级版本，需先在新服务器上升级GitLab至目标版本，再恢复数据。
• 备份文件安全：备份文件包含敏感信息（如用户密码哈希、代码），需加密存储或传输（如使用scp -i 私钥）。
• 测试恢复流程：建议先在测试环境（如虚拟机）演练迁移步骤，确保熟悉流程后再进行生产环境迁移。
• 自动备份设置：迁移完成后，建议在新服务器上配置自动备份（如每天凌晨3点），避免数据丢失：
  编辑/etc/gitlab/gitlab.rb，添加：

  gitlab_rails['backup_keep_time'] = 604800  # 保留7天备份
  gitlab_rails['backup_cron'] = "0 3 * * *"  # 每天凌晨3点执行
  

  保存后重新加载配置：sudo gitlab-ctl reconfigure。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！