ubuntu上gitlab版本升级指南 - 问答

Ubuntu 上 GitLab 版本升级指南

一升级前准备

明确版本与仓库：确认当前是 GitLab CE 还是 GitLab EE，并核对现有版本号。
命令：sudo gitlab-rake gitlab:env:info（查看 Version 字段）；cat /opt/gitlab/embedded/service/gitlab-rails/VERSION（备用查看方式）。
完整备份：先停机或确保业务允许短时中断，再做全量备份（数据库与仓库）。
命令：gitlab-rake gitlab:backup:create；如需自定义备份目录，先在 /etc/gitlab/gitlab.rb 中设置 gitlab_rails[‘backup_path’]，再执行备份并重载：gitlab-ctl reconfigure。
阅读发行说明与升级路径：对照目标版本的发布说明检查变更项与注意事项；若跨多个主版本，需按官方路径逐步升级，避免直接跨大版本。
系统与资源：执行系统更新（sudo apt update && sudo apt upgrade），并确保资源充足（例如某些版本建议至少 4GB 内存）。
可选快照：为实例或数据盘做快照，便于回滚。

二标准升级步骤

更新软件包索引与仓库脚本：
命令：sudo apt update；
社区版：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash；
企业版：wget -qO- https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash。
执行升级：
直接到目标版本（适用于小版本或已按路径逐步升级到接近目标的情况）：sudo apt-get install gitlab-ce 或 gitlab-ee；
指定版本（如需精确控制版本）：sudo apt-get install gitlab-ce= 或 gitlab-ee=。
重新配置与重启：sudo gitlab-ctl reconfigure；sudo gitlab-ctl restart。
验证：访问 Web 页面登录验证，或执行 sudo gitlab-rake gitlab:env:info 确认已到目标版本。

三跨版本与多阶段升级路径

基本原则：多数情况下不支持跨多个主版本直接升级，需要按官方“升级路径”逐跳升级。
示例路径（旧版场景）：8.11.Z → 8.12.0 → 8.17.7 → 9.5.10 → 10.8.7 → 11.11.8 → 12.0.12 → 12.1.17 → 12.10.14 → 13.0.14 → 13.1.11 → 13.8.8 → 13.12.15 → 14.0.12 → latest 14.Y.Z。
实操要点：每完成一个中间版本，建议登录验证关键功能（登录、CI/CD、仓库克隆/推送、Webhooks 等）正常后再继续下一跳。

四常见问题与回滚

502 Bad Gateway（外部 Nginx 场景）：部分版本（如 13.5+）后 gitlab-workhorse 的 socket 路径由 /var/opt/gitlab/gitlab-workhorse/socket 调整为 /var/opt/gitlab/gitlab-workhorse/sockets/socket，需同步更新 Nginx upstream：
upstream gitlab-workhorse { server unix:/var/opt/gitlab/gitlab-workhorse/sockets/socket; }，然后执行 nginx -s reload。
配置语法变更：例如老写法 git_data_dir 在新版本需改为 git_data_dirs({ “default” => { “path” => “/data/git” } })，修改后执行 gitlab-ctl reconfigure。
回滚方案：若有系统快照可直接回滚；否则使用备份恢复：先安装目标旧版本包，再执行 gitlab-rake gitlab:backup:restore，最后 gitlab-ctl reconfigure 与重启。

五建议的升级顺序清单

0 赞

0 踩