CentOS怎么升级GitLab

在 CentOS 上升级 GitLab 通常有两种情况：Omnibus 安装方式（官方推荐） 和 RPM 包方式。下面以 最常见、最安全的 Omnibus 方式 为例，给你一个完整、可操作的升级流程。

一、确认当前 GitLab 安装方式

gitlab-ctl status

如果能正常显示服务状态，说明是 Omnibus 安装方式，可以继续下面的步骤。

二、升级前必做（非常重要）

1️⃣ 备份 GitLab（强烈建议）

gitlab-backup create

备份文件默认在：

/var/opt/gitlab/backups/

⚠️ 注意：

备份不包含配置文件
配置文件需单独备份：

cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak
cp /etc/gitlab/gitlab-secrets.json /etc/gitlab/gitlab-secrets.json.bak

2️⃣ 查看当前版本

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

三、升级 GitLab（CentOS 7 / 8）

✅ 方式一：直接升级到最新版（推荐）

1️⃣ 更新 YUM 源（如果已配置可跳过）

GitLab 官方源：

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

如果是 CE 社区版：

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | bash

2️⃣ 升级 GitLab

CE 版本：

yum install gitlab-ce -y

EE 版本：

yum install gitlab-ee -y

如果提示版本冲突，可先执行：

yum clean all

3️⃣ 重新配置并重启

gitlab-ctl reconfigure
gitlab-ctl restart

四、跨大版本升级（重点）

⚠️ GitLab 不支持跨多个大版本直接升级

正确升级路径示例：

14.0 → 14.10 → 15.0 → 15.11 → 16.x

指定版本升级方式：

yum install gitlab-ce-15.11.13 -y
gitlab-ctl reconfigure

查看可用版本：

yum --showduplicates list gitlab-ce

五、升级后检查

gitlab-ctl status
gitlab-rake gitlab:check SANITIZE=true

访问 Web 页面确认是否正常。

六、常见问题

❌ 升级后 502 / 500 错误

gitlab-ctl restart
gitlab-ctl tail

❌ PostgreSQL 升级失败

gitlab-ctl pg-upgrade

七、CentOS 已停止维护的情况

如果你使用的是 CentOS 7/8（已 EOL）：

✅ 建议：

迁移到 Rocky Linux / AlmaLinux
或升级到 GitLab 16.x（最后支持 CentOS 的版本）

八、我可以帮你进一步确认

你可以直接把下面信息发我，我可以给你精确升级方案：

cat /etc/redhat-release
gitlab-rake gitlab:env:info

是否需要 CE / EE？
是否要 跨大版本升级？