ubuntu上gitlab版本如何更新

Ubuntu 上 GitLab 升级指南

一 升级前准备

• 备份数据与配置：执行备份命令并将产物拷贝到安全位置；注意备份不会包含敏感文件 gitlab-secrets.json 与 gitlab.rb，需单独妥善备份。示例：sudo gitlab-backup create（或旧版本使用 gitlab-rake gitlab:backup:create）。备份默认位于 /var/opt/gitlab/backups。完成后建议检查可用空间与备份文件权限。
• 查看当前版本与仓库：确认现有安装的是 CE/EE/JH 哪一版及其版本号，并检查可升级版本。示例：apt policy gitlab-ce（或 gitlab-ee / gitlab-jh）。
• 阅读版本发布说明与升级路径：跨多个主版本升级前，先按官方说明执行逐步升级，避免直接跳级导致迁移失败。参考：https://docs.gitlab.com/ee/release_notes/

二 标准升级步骤 Omnibus 包

• 更新软件包索引：sudo apt update
• 执行升级（按实际安装选择其一）：
  • 社区版 CE：sudo apt install gitlab-ce
  • 企业版 EE：sudo apt install gitlab-ee
  • 极狐版 JH：sudo apt install gitlab-jh
• 重新配置并重启：sudo gitlab-ctl reconfigure，必要时 sudo gitlab-ctl restart
• 验证版本：访问 /help 页面或在命令行查看 apt policy gitlab-ce|ee|jh 与 cat /opt/gitlab/embedded/service/gitlab-rails/VERSION

三 指定版本与跨版本升级

• 指定版本安装（适用于回滚或精确升级）：sudo apt install gitlab-ce=15.0.5-ce.0（EE 将 ce 换为 ee，JH 使用 gitlab-jh 对应版本）。
• 跨版本路径建议：例如从 15.x 升级到 17.x，应先逐步升级到中间版本（如先到 16.x 的最新补丁），每一步都完成备份与 gitlab-ctl reconfigure，再继续下一跳，避免一次性跨度过大。

四 升级后的检查与常见问题

• 检查服务状态：sudo gitlab-ctl status，确认所有组件（如 nginx、postgresql、puma/unicorn、sidekiq）均为 run 状态。
• 访问 /help 核对版本号，或在控制台查看：cat /opt/gitlab/embedded/service/gitlab-rails/VERSION。
• 如遇异常：优先回滚到升级前备份；检查 /var/log/gitlab/ 下相关日志，必要时在维护窗口内重试升级流程。

五 不同安装方式一览