debian gitlab怎样升级

在 Debian 上升级 GitLab（通常指 GitLab CE/EE 的 Omnibus 安装方式）一般分为几种场景。下面给你一套标准、安全的升级流程。

一、升级前准备（非常重要）

1. 查看当前版本

sudo gitlab-rake gitlab:env:info

或

cat /opt/gitlab/version-manifest.txt

2. 备份（必须）

sudo gitlab-rake gitlab:backup:create

备份文件在：

/var/opt/gitlab/backups/

同时备份配置：

sudo tar czf gitlab-config-$(date +%F).tar.gz /etc/gitlab

3. 查看升级路径（关键）

⚠️ GitLab 不能跨大版本直接升级
例如：

13.0 → 13.12 → 14.0 → 14.9 → 15.0 → 15.x

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

二、Debian 上升级 GitLab（Omnibus）

方式一：使用官方 apt 源（推荐）

1. 更新 apt

sudo apt update

2. 升级 GitLab

sudo apt install gitlab-ee   # EE 版
# 或
sudo apt install gitlab-ce   # CE 版

如果只想升级到指定版本：

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

方式二：手动下载 deb 包升级

wget https://packages.gitlab.com/gitlab/gitlab-ce/packages/debian/bullseye/gitlab-ce_15.11.0-ce.0_amd64.deb
sudo dpkg -i gitlab-ce_15.11.0-ce.0_amd64.deb

三、升级后操作

1. 重新配置

sudo gitlab-ctl reconfigure

2. 检查状态

sudo gitlab-ctl status

3. 检查数据库迁移

sudo gitlab-rake db:migrate
sudo gitlab-rake gitlab:check

四、Docker 安装的 GitLab（补充）

如果是 Docker：

docker pull gitlab/gitlab-ce:15.11.0-ce.0
docker stop gitlab
docker rm gitlab
docker run ...（保持原有 volume）

五、常见问题

1. 升级卡住

检查磁盘空间
查看日志：

sudo gitlab-ctl tail

2. 版本跳跃太大报错

→ 必须按官方升级路径逐步升

3. 配置文件变化

升级后检查：

diff gitlab-config-*.tar.gz /etc/gitlab

六、示例：13.12 → 15.11 升级顺序

13.12 → 14.0 → 14.3 → 14.9 → 15.0 → 15.4 → 15.11

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

Debian 版本（10/11/12）
GitLab 版本（CE/EE）
安装方式（apt / docker / 源码）

我可以给你精确到版本的升级命令。