Linux下GitLab的迁移步骤是什么

Linux下GitLab迁移的详细步骤

1. 迁移前准备

确认版本一致性：确保新旧GitLab服务器版本完全一致（如均为GitLab CE 15.10或EE 15.10），版本不匹配会导致恢复失败。
备份现有数据：迁移前务必备份原GitLab的所有关键数据，避免操作失误导致数据丢失。

2. 备份原GitLab数据

2.1 使用GitLab内置工具备份

运行以下命令创建完整备份（包含数据库、仓库、附件、配置等）：

sudo gitlab-rake gitlab:backup:create

默认备份文件存储在/var/opt/gitlab/backups/目录，文件名格式为时间戳_版本号_gitlab_backup.tar（如1716585600_15.10.0_gitlab_backup.tar）。

2.2 备份关键配置文件

手动复制以下配置文件到安全位置（如外部存储或新服务器临时目录）：

/etc/gitlab/gitlab.rb：GitLab主配置文件（含外部URL、邮件设置、备份路径等）；
/etc/gitlab/gitlab-secrets.json：存储数据库密钥、OAuth令牌等敏感信息（必备份，否则无法恢复）。

3. 安装新服务器GitLab

3.1 安装指定版本GitLab

在新服务器上安装与原服务器完全相同的GitLab版本（以GitLab CE为例）：

# 添加GitLab官方仓库（以CentOS为例）
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

# 安装指定版本（如15.10.0）
sudo yum install -y gitlab-ce-15.10.0-ce.0.el7.x86_64

3.2 配置基础参数

编辑/etc/gitlab/gitlab.rb，设置外部URL（需与原服务器一致，避免用户链接失效）：

external_url 'http://your-new-server-ip'

保存后重新配置GitLab：

sudo gitlab-ctl reconfigure

3.3 启动GitLab服务

sudo gitlab-ctl start
sudo gitlab-ctl enable  # 设置开机自启

4. 恢复数据到新服务器

4.1 传输备份文件

将原服务器的备份文件（gitlab_backup.tar）和配置文件（gitlab.rb、gitlab-secrets.json）复制到新服务器对应目录：

# 复制备份文件
scp /path/to/original/gitlab_backup.tar root@new-server:/var/opt/gitlab/backups/

# 复制配置文件
scp /etc/gitlab/gitlab.rb root@new-server:/etc/gitlab/
scp /etc/gitlab/gitlab-secrets.json root@new-server:/etc/gitlab/

4.2 恢复备份

修改备份文件权限：确保GitLab用户（默认git）有权访问备份文件：
```
sudo chown git:git /var/opt/gitlab/backups/gitlab_backup.tar
```
执行恢复命令：
```
sudo gitlab-rake gitlab:backup:restore BACKUP=时间戳
```
其中时间戳为备份文件名中的时间部分（如1716585600）。恢复过程会覆盖新服务器上的现有数据，需确认操作。

4.3 恢复配置文件

将原服务器的配置文件复制到新服务器对应目录：

sudo cp /path/to/original/gitlab.rb /etc/gitlab/
sudo cp /path/to/original/gitlab-secrets.json /etc/gitlab/

4.4 重新配置并重启

sudo gitlab-ctl reconfigure  # 应用新配置
sudo gitlab-ctl restart     # 重启服务使配置生效

5. 验证迁移结果

访问Web界面：通过浏览器访问新服务器的外部URL（如http://your-new-server-ip），确认能正常登录。
检查数据完整性：
- 验证项目仓库：进入任意项目，查看代码、提交历史、分支等是否完整；
- 验证用户权限：检查用户组、角色、SSH密钥等是否与原服务器一致；
- 验证配置：确认外部URL、邮件通知、备份路径等设置是否生效。

6. 清理与优化（可选）

删除旧服务器数据：确认新服务器迁移成功后，可清理原服务器上的GitLab数据（需提前备份）；
更新DNS记录：若更换了服务器IP，需将域名解析到新IP；
设置监控：配置GitLab监控（如Prometheus+Granafa），及时发现异常。