ubuntu中gitlab迁移指南

Ubuntu环境下GitLab迁移指南

GitLab迁移是确保代码托管服务连续性的关键操作，需严格遵循步骤以避免数据丢失。以下是基于Ubuntu系统的详细迁移流程及注意事项：

一、迁移前准备

1. 确认新服务器环境
   新服务器需满足GitLab的系统要求（如Ubuntu 22.04/20.04 LTS、2GB以上内存、50GB以上存储），并提前安装必要依赖（如curl、openssh-server）。
2. 备份原GitLab数据
   使用GitLab内置工具创建完整备份，覆盖仓库、用户信息、CI/CD配置、Wiki等内容：

   sudo gitlab-rake gitlab:backup:create
   

   备份文件默认存储在/var/opt/gitlab/backups目录，文件名格式为YYYY-MM-DD-HH-mm-ss_gitlab_backup.tar。
3. 停止GitLab服务
   为避免数据冲突，迁移前需停止GitLab核心服务：

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

二、新服务器安装GitLab

1. 添加GitLab软件源
   导入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（社区版）
   执行安装命令并根据新服务器IP/域名配置外部访问URL（替换your-new-gitlab-url）：

   sudo apt-get install gitlab-ce
   sudo EXTERNAL_URL="http://your-new-gitlab-url" gitlab-ctl reconfigure
   

三、迁移数据至新服务器

1. 传输备份文件
   使用scp将原服务器备份文件复制到新服务器的/var/opt/gitlab/backups目录（需确保目标目录存在且具备git用户写入权限）：

   scp -r user@old-server:/var/opt/gitlab/backups/* user@new-server:/var/opt/gitlab/backups/
   

2. 恢复备份数据
   恢复前需修改备份文件权限（属主为git），然后执行恢复命令（将YYYY-MM-DD-HH-mm-ss替换为实际备份文件名）：

   sudo chown git:git /var/opt/gitlab/backups/your_backup_file.tar
   sudo gitlab-rake gitlab:backup:restore BACKUP=your_backup_file
   

四、配置与启动新实例

1. 调整配置文件
   编辑/etc/gitlab/gitlab.rb，根据新服务器环境修改以下关键参数：
   • external_url：设置为新服务器的访问URL（如http://new-ip或域名）；
   • gitlab_rails['gitlab_shell_ssh_port']：若SSH端口变更，需同步更新；
   • 邮件/数据库/LDAP等集成配置（若有使用）。
     修改后重新配置GitLab：

   sudo gitlab-ctl reconfigure
   

2. 启动GitLab服务
   启动所有核心服务并设置开机自启：

   sudo gitlab-ctl start
   sudo gitlab-ctl enable
   

五、验证迁移结果

1. 访问新实例
   通过浏览器访问EXTERNAL_URL，确认GitLab首页能正常加载。
2. 检查数据完整性
   • 登录管理员账号，验证用户、项目、CI/CD流水线、Wiki等内容是否完整；
   • 测试代码推送/拉取（git clone新地址，推送提交），确认仓库功能正常；
   • 检查用户权限（如管理员、开发者角色）是否与原实例一致。

六、迁移后注意事项

1. DNS更新（若域名变更）
   若新服务器IP与原服务器不同，需更新DNS解析记录（A记录或CNAME），确保用户通过原域名访问新实例。
2. 监控与备份
   迁移后持续监控新服务器性能（CPU、内存、磁盘），并定期执行备份（建议每日增量备份+每周全量备份）。
3. 回退计划
   迁移前停止原服务器的代码提交，若新实例出现问题，可快速恢复原服务器服务（停止新服务，重启原服务）。
4. 版本一致性
   建议新旧服务器使用相同版本的GitLab，避免因版本差异导致数据兼容性问题（如升级需参考官方升级指南）。