Debian系统中GitLab如何进行数据迁移

Debian系统中GitLab数据迁移详细步骤

一、迁移前准备工作

1. 版本兼容性检查：确保新旧Debian服务器上的GitLab版本一致或兼容（如旧版本为15.0，新版本需≥15.0）。若版本差异较大，需先在新服务器上升级GitLab至与旧服务器匹配的版本。
2. 备份旧服务器数据：迁移前必须完整备份旧服务器的所有关键数据（包括仓库、数据库、配置文件、附件等），防止迁移过程中数据丢失。
3. 新服务器环境准备：在新Debian服务器上安装与旧服务器相同版本的GitLab（参考GitLab官方文档安装步骤），并确保服务器硬件配置（CPU、内存、存储）满足GitLab运行需求。

二、旧服务器数据备份

1. 使用GitLab内置工具备份所有数据

运行以下命令创建完整备份（默认备份文件包含数据库、Git仓库、CI/CD配置、上传文件等）：

sudo gitlab-rake gitlab:backup:create

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

2. 手动备份配置文件与证书

为确保配置一致性，需单独备份GitLab配置文件和SSL证书：

sudo cp /etc/gitlab/gitlab.rb /your/backup/path/  # 备份主配置文件
sudo cp -r /etc/gitlab/ssl /your/backup/path/   # 备份SSL证书（若使用HTTPS）

三、新服务器安装GitLab

1. 添加GitLab软件源：运行以下命令添加GitLab官方APT源：

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

2. 安装GitLab社区版：执行安装命令（替换EXTERNAL_URL为新服务器的域名或IP）：

sudo EXTERNAL_URL="http://your-new-gitlab-domain.com" apt-get install gitlab-ce

3. 初始配置：安装完成后，运行sudo gitlab-ctl reconfigure应用配置，启动GitLab服务。

四、迁移数据至新服务器

1. 传输备份文件到新服务器

使用scp命令将旧服务器的备份文件（含数据、配置、证书）复制到新服务器的对应目录：

scp -r /var/opt/gitlab/backups/your_backup_file.tar user@new-server:/var/opt/gitlab/backups/
scp -r /your/backup/path/gitlab.rb user@new-server:/etc/gitlab/
scp -r /your/backup/path/ssl user@new-server:/etc/gitlab/

2. 恢复备份数据

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

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

2. 执行恢复操作：进入备份目录，运行恢复命令（将BACKUP=时间戳替换为备份文件的前缀）：

cd /var/opt/gitlab/backups
sudo gitlab-rake gitlab:backup:restore BACKUP=1717411200

恢复过程中会提示“是否覆盖现有数据”，输入yes确认。

3. 恢复配置文件与证书：将备份的配置文件和SSL证书复制到新服务器的对应目录：

sudo cp /your/backup/path/gitlab.rb /etc/gitlab/
sudo cp -r /your/backup/path/ssl /etc/gitlab/

运行sudo gitlab-ctl reconfigure使配置生效。

五、启动新服务器并验证

1. 启动GitLab服务：运行以下命令启动所有GitLab服务：

sudo gitlab-ctl start

2. 验证数据完整性：
   • 访问新服务器的GitLab Web界面（http://your-new-gitlab-domain.com），检查用户、项目、CI/CD配置等是否正常显示。
   • 克隆一个测试项目到本地，验证代码仓库是否能正常读写。

注意事项

• 权限问题：确保备份文件和新服务器上的GitLab目录（如/var/opt/gitlab）属主为git用户（可通过chown -R git:git /var/opt/gitlab修复）。
• 测试环境验证：建议先在测试服务器上完成迁移流程，确认无误后再迁移生产环境。
• 自动备份设置：迁移完成后，可配置自动备份（修改/etc/gitlab/gitlab.rb中的gitlab_rails['backup_path']和gitlab_rails['backup_keep_time']，然后运行sudo gitlab-ctl reconfigure）。