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。

0 赞

0 踩