debian gitlab如何升级

下面按常见场景给你讲一下 Debian 上 GitLab 的升级方法。先确认你是哪种安装方式，再照着做。

一、先确认 GitLab 安装方式

sudo gitlab-rake gitlab:env:info

或看包类型：

dpkg -l | grep gitlab

通常有两种：

• Omnibus（gitlab-ee / gitlab-ce） ✅ 最常见
• 源码安装（不推荐，已很少用）

二、Omnibus 安装（推荐方式）

1️⃣ 备份（非常重要）

sudo gitlab-rake gitlab:backup:create

配置文件也要备份：

sudo cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak
sudo cp -R /etc/gitlab/ssl /etc/gitlab/ssl.bak

2️⃣ 查看当前版本

sudo gitlab-rake gitlab:env:info
# 或
cat /opt/gitlab/version-manifest.txt

3️⃣ 升级路径（⚠️重点）

GitLab 不能跨大版本直接升，例如：

8.x → 9.x → 10.x → 11.x → 12.x → 13.x → 14.x → 15.x → 16.x

✅ 官方升级路径工具： https://gitlab-com.gitlab.io/support/toolbox/upgrade-path/

例如：

• 13.12 → 14.0 → 14.9 → 15.0 → 15.11 → 16.x

4️⃣ 升级步骤（以 15 → 16 为例）

（1）更新 apt 源

sudo apt-get update

（2）升级到下一个中间版本

sudo apt-get install gitlab-ee=15.11.13-ee.0

（3）重新配置

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

（4）继续升级

sudo apt-get install gitlab-ee=16.0.0-ee.0
sudo gitlab-ctl reconfigure

5️⃣ 升级后检查

sudo gitlab-rake gitlab:check
sudo gitlab-ctl status

三、使用官方脚本（可选）

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

然后：

sudo apt-get install gitlab-ee

⚠️ 仅适合小版本升级

四、Docker 方式（如果你是用容器）

docker pull gitlab/gitlab-ee:16.0.0-ee.0
docker stop gitlab
docker rm gitlab
docker run ...（同原来参数）

五、常见坑

❌ 直接跨大版本升级 → 数据库迁移失败
❌ 忘记备份 /etc/gitlab
❌ 磁盘空间不足（至少留 2–5G）
❌ PostgreSQL 升级失败（GitLab 16 要求 PG 13+）

六、我可以帮你更具体

你可以直接告诉我：

1. 当前 GitLab 版本
2. Debian 版本（cat /etc/os-release）
3. 安装方式（Omnibus / Docker / 源码）

我可以给你精确的升级命令序列。