ubuntu上如何升级gitlab

Ubuntu 上 GitLab 升级指南

一 升级前准备

• 备份数据与配置：先创建完整备份，包含数据库与仓库数据，备份文件默认位于 /var/opt/gitlab/backups/；如需跳过包管理器自动备份，可创建空文件 /etc/gitlab/skip-auto-backup。命令示例：sudo gitlab-backup create（或旧版本使用：gitlab-rake gitlab:backup:create）。同时建议备份配置文件 /etc/gitlab/gitlab.rb 与 /etc/gitlab/gitlab-secrets.json。
• 检查运行状态与后台迁移：确认无正在进行的后台迁移，避免升级导致数据不一致。命令示例：sudo gitlab-ctl status；如需详细自检：sudo gitlab-rake gitlab:check SANITIZE=true。
• 升级节奏与兼容性：跨主版本升级必须遵循官方升级路径，先升级到目标主版本的最新小版本，再继续；建议主要/次要版本之间升级间隔不超过 1 周，以便完成后台迁移。若为多节点（含 Gitaly），先升级 Gitaly 节点，避免 gRPC 不兼容。
• 版本确认：查看当前已安装版本，命令示例：cat /opt/gitlab/embedded/service/gitlab-rails/VERSION。

二 标准升级步骤（同系列小版本或补丁）

• 更新软件索引并升级 GitLab 包：
  • Ubuntu/Debian（CE 版）：sudo apt update && sudo apt install gitlab-ce
  • Ubuntu/Debian（EE 版）：sudo apt update && sudo apt install gitlab-ee
  • 极狐 GitLab（JH 版）：sudo apt update && sudo apt install gitlab-jh
• 重新配置并重启：sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart
• 验证：访问 /help 页面或执行：cat /opt/gitlab/embedded/service/gitlab-rails/VERSION，确认已到目标版本。

三 跨主版本升级与指定版本安装

• 查看可用版本：apt-cache madison gitlab-ce（或 gitlab-ee/gitlab-jh），确定目标主版本的最新小版本号。
• 按官方升级路径分阶段升级：例如从 14.x 升到 15.x，需先升级到 15.0.x 的最新补丁，再继续到更高版本。命令示例：sudo apt install gitlab-ce=15.0.2-ce.0（将版本号替换为你的目标小版本）。
• 继续升级：完成上一阶段后，再执行 sudo apt install gitlab-ce 升级到最新 15.Y.Z。
• 若使用极狐 GitLab：sudo apt install gitlab-jh=15.0.2-jh.0，随后再升级到最新 15.Y.Z。

四 升级后验证与常见问题

• 验证与自检：
  • 服务状态：sudo gitlab-ctl status
  • 配置与依赖检查：sudo gitlab-rake gitlab:check SANITIZE=true
  • 版本核对：cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
• 常见问题处理：
  • 跨主版本报错（如 14 → 15）：预安装脚本会阻止直接升级，需先升级到目标主版本的最新小版本（如 15.0.x）。
  • APT GPG 签名验证失败：更新仓库 GPG 公钥后重试，示例：curl --silent “https://packages.gitlab.cn/repository/raw/gpg/public.gpg.key” | apt-key add - && apt-get update。
  • 升级后 Runner 不可用：确保 GitLab Runner 与 GitLab 版本匹配（如均使用 17.x 系列），必要时重新注册 Runner。