如何升级debian gitlab

升级 Debian 上的 GitLab 需要谨慎操作，因为 GitLab 包含数据库、仓库数据等关键内容。下面按**官方推荐方式（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  # 如有

2. 查看当前版本

sudo gitlab-rake gitlab:env:info

或

cat /opt/gitlab/version-manifest.txt

二、GitLab 升级路径规则（关键）

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

• 14.0 → 14.9 → 15.0 → 15.11 → 16.0

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

三、使用 apt 升级（Omnibus 方式）

1. 更新 apt 源

sudo apt update

2. 升级 GitLab 到指定版本

例如升级到 16.11：

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

或社区版：

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

如果直接 apt upgrade，会升级到仓库中的最新版，可能违反升级路径。

3. 重新配置并重启

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

四、检查升级结果

sudo gitlab-rake gitlab:check SANITIZE=true

访问 Web 页面确认版本号。

五、Docker 方式（如你用的是容器）

docker pull gitlab/gitlab-ee:16.11.0-ee.0
docker stop gitlab
docker rm gitlab
docker run ...（保持原参数）

六、常见问题

1. 升级卡在数据库迁移

sudo gitlab-ctl tail

查看日志，不要强行中断。

2. 升级失败回滚

使用之前的备份：

sudo gitlab-rake gitlab:backup:restore BACKUP=时间戳

七、建议

• 先在测试环境演练
• 选择维护窗口升级
• 小版本升级风险低，大版本务必按路径

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

• GitLab 当前版本
• 安装方式（Omnibus / Docker / 源码）
• Debian 版本

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