离线（Air-gapped）环境下GitLab升级失败求助

问题原因 #

rpm -i 命令仅用于安装全新包，当系统中已存在旧版本GitLab时，该命令不会执行升级操作，只会提示包已安装（可能你未留意到该提示），因此版本未发生变化。

解决步骤 #

1. 确认当前GitLab版本 #

先执行命令确认当前版本，验证升级未生效的状态：

gitlab-rake gitlab:env:info | grep Version

2. 使用正确的rpm升级命令 #

针对已安装的包，需使用升级专用命令：

rpm -Uvh gitlab-ce-15.6.1-ce.0.el8.x86_64.rpm

参数说明：

• -U：升级模式，会安装新版本并替换旧版本
• -v：显示详细执行过程
• -h：显示进度条，便于跟踪升级状态

3. 重载GitLab配置并重启服务 #

升级完成后，必须执行配置重载和服务重启，确保新版本生效：

gitlab-ctl reconfigure
gitlab-ctl restart

4. 再次验证升级结果 #

重新执行版本查看命令，确认已成功升级到目标版本：

gitlab-rake gitlab:env:info | grep Version

额外注意事项 #

• 离线环境升级前，务必确认下载的rpm包与当前系统架构（x86_64）、RHEL版本（el8）完全匹配
• 若之前修改过GitLab配置文件，建议升级前备份/etc/gitlab/gitlab.rb，gitlab-ctl reconfigure会保留自定义配置，但备份可避免意外问题
• 若升级时出现依赖缺失，需提前下载对应依赖rpm包并手动安装（离线环境需自行梳理依赖链）

内容的提问来源于stack exchange，提问作者GULAM MOIDEEN