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 与重启。

五 建议的升级顺序清单

• 准备与评估：备份（含自定义备份目录与权限）、核对 CE/EE 与当前版本、阅读发行说明与升级路径、系统更新与资源检查、必要时做快照。
• 执行升级：更新索引与仓库脚本 → 安装目标/指定版本 → 重新配置与重启 → 登录与关键功能验证。
• 多阶段升级：按官方路径逐跳升级，每跳验证后再继续。
• 善后：观察日志与监控告警，确认无误后再对外恢复全量流量。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！