如何通过Debian GitLab数据库迁移，轻松实现高效数据迁移与备份操作？

在进行 Debian 环境下 GitLab 数据库迁移时很多管理员都会遇到以下痛点：

• 担心数据丢失或迁移后出现不一致。
• 不确定新旧服务器的 GitLab 版本是否兼容，导致恢复失败。
• 停机窗口有限，迁移过程需要在最短时间内完成。
• 手动操作繁琐，容易出现配置遗漏或权限错误。
• 备份文件传输过程中可能因网络问题导致中断。

一、迁移前准备工作

1. 版本兼容性检查

在旧服务器上查看当前 GitLab 版本：

# 查看旧服务器 GitLab 版本
cat /opt/gitlab/embedded/service/gitlab-rails/VERSION

确认新服务器安装相同或更高版本，否则先升级后再迁移。

2. 完整备份关键数据

必须先做好完整备份，否则任何错误都无法恢复！不过，

# 在旧服务器执行全量备份
sudo gitlab-rake gitlab:backup:create
# 备份文件默认位于 /var/opt/gitlab/backups/
# 同时单独拷贝配置文件
sudo cp /etc/gitlab/gitlab.rb /tmp/
sudo cp /etc/gitlab/gitlab-secrets.json /tmp/

3. 创建停机窗口并关闭服务

为保证一致性。请提前规划好停机时间，并在迁移前停止所有 GitLab 服务：

# 停止所有服务
sudo gitlab-ctl stop
# 或者单独停止 Unicorn、Sidekiq 等
sudo gitlab-ctl stop unicorn sidekiq

二、选择合适的迁移方式

A. 整机备份与恢复

最常用且风险最低的方法：使用 Omnibus 内置的备份工具打包整个实例，接下来在新服务器恢复。老实说，适合一次性搬迁整个环境。

1. 步骤 1：创建全量备份
2. 步骤 2：将备份文件及配置复制到新服务器：

# 在新服务器创建备份目录并赋予权限
mkdir -p /var/opt/gitlab/backups && chmod 777 /var/opt/gitlab/backups
# 使用 scp 复制备份文件
scp root@旧服务器:/var/opt/gitlab/backups/2024_09_04_16.2.4_gitlab_backup.tar \
root@新服务器:/var/opt/gitlab/backups/
# 拷贝配置文件
scp root@旧服务器:/etc/gitlab/*.rb* root@新服务器:/etc/gitlab/
scp root@旧服务器:/etc/gitlab/*.json* root@新服务器:/etc/gitlab/

步骤 3：在新服务器安装相同版本的 GitLab：

# 添加官方仓库并安装
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo apt-get update && sudo apt-get install gitlab-ce=<当前版号>-ce

sudo editor /etc/gitlab/gitlab.rb

sudo gitlab-ctl reconfigure && sudo gitlab-ctl start

cd /var/opt/gitgitlabsbackups/ sudo gitla…gitla，# 简化为示例: sudo gitla…`` 至于**注意**，恢复命令为sudo gitla…`，怎么说呢，

痛点解决此方法几乎不需要手动操作数据库导出导入。降低了人为错误，通过完整打包包含仓库、附件和配置，一键恢复即可。

---

B. 单独数据库迁移

If you just want to move PostgreSQL data but keep same application files:

1. Create a database dump on old server:

# 登录 PostgreSQL 并导出数据库
sudo -u postgres pgdumpall> pgall.sql

pgdump -Fc --no-acl --no-owner -U git -d gitlab> git_lab.dump

# 使用 scp 或 rsync 将转储文件复制到目标机器
scp pg_all.sql root@new-server:/tmp/

# 恢复所有数据库
psql -U postgres -f /tmp/pg_all.sql 

pgrestore --verbose --clean --no-acl --no-owner -U postgres -d gitlab /tmp/git_lab.dump

---

C. 仓库级别镜像推送

If you only need to migrate selected projects:

• Create project mirror URL on new instance.

# 在旧实例克隆项目镜像
git clone --mirror https://old-git.example.com/group/project.git
cd project.git && \
git push --mirror https://new-git.example.com/group/project.git



常见问题与注意事项


数据一致性检查
• 确认所有使用者、项目和 CI 配置均已同步。• 对比老版与新版日志，确保无报错。

权限与方法问题
• 新环境下 `/var/opt` 的拥有者应为 `git`。• 如有自定义上传目录，记得同步方法并设置正确权限。

网络传输稳定性
• 对大容量转储建议使用 `rsync` + `--partial` 或 `pv` 检查进度。

停机时间最小化
• 使用快照+增量同步，在正式切换前做一次小规模验证。话说回来，

安全加固
• 移除临时 SSH 密钥；关闭旧实例访问，


小结


完整方案Omnibus 全量打包 + 恢复 → 最少误差。怎么说呢，

只换 DBPostgreSQL dump & restore → 高效且灵活。

只选项目Git 镜像推送 → 快速满足业务需求。


按照上述步骤操作。并密切关注每一步的日志输出，即可比较容易做到高效、安全的数据迁移与备份。