怎样在debian升级gitlab

在 Debian 上“升级 GitLab”通常有两种常见情况，下面分别说明。最重要的一点：升级前一定要备份。

一、先确认你当前 GitLab 的安装方式

dpkg -l | grep gitlab

常见有两种：

• Omnibus 包（官方推荐，包名通常是 gitlab-ee 或 gitlab-ce）
• 源码安装（较少见，不推荐）

下面以 Omnibus 安装 为主（最常见）。

二、升级前的准备工作（强烈建议）

1. 备份 GitLab

sudo gitlab-rake gitlab:backup:create

备份文件默认在：

/var/opt/gitlab/backups/

同时备份配置：

sudo cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak
sudo cp -R /etc/gitlab/ssl /etc/gitlab/ssl.bak  # 如果有

三、使用 apt 升级 GitLab（Omnibus）

1. 更新 apt 源

sudo apt update

2. 查看可升级版本

apt-cache policy gitlab-ee   # 或 gitlab-ce

3. 升级 GitLab

sudo apt install gitlab-ee   # 或 gitlab-ce

或升级到指定版本：

sudo apt install gitlab-ee=16.11.0-ee.0

⚠️ 注意：GitLab 不支持跨大版本直接升级 例如：

• 14.x → 15.x → 16.x
• 必须逐级升级，不能 13 → 16

官方升级路径工具： https://docs.gitlab.com/ee/update/#upgrade-paths

四、升级后操作

1. 重新配置

sudo gitlab-ctl reconfigure

2. 重启服务（通常会自动完成）

sudo gitlab-ctl restart

3. 检查状态

sudo gitlab-ctl status

4. 检查版本

sudo gitlab-rake gitlab:env:info

五、如果跨多个大版本（重要）

例如你现在是 13.12，目标是 16.11：

升级顺序应为：

13.12 → 14.0 → 14.10 → 15.0 → 15.11 → 16.0 → 16.11

每一步：

sudo apt install gitlab-ee=14.0.0-ee.0
sudo gitlab-ctl reconfigure
# 确认正常后再继续

六、常见问题

1. 升级失败卡住

• 查看日志：

sudo gitlab-ctl tail

2. PostgreSQL 升级失败

• GitLab 会自动升级 PG
• 不要手动删 PG 数据

3. 磁盘空间不足

• 至少需要 2–3 倍 GitLab 数据大小 的空闲空间

七、升级完成后建议

• 删除旧备份前确认新版本稳定
• 定期检查：

sudo gitlab-rake gitlab:check

如果你愿意，可以告诉我：

• 当前 GitLab 版本
• Debian 版本
• 是 CE 还是 EE

我可以给你精确的升级步骤和命令。