GitLab在Debian中如何更新

Debian 上更新 GitLab 的标准流程

一 准备与备份

• 确认当前版本与升级路径：查看已安装版本与运行状态，避免跨多版本跳跃升级。示例：sudo gitlab-rake gitlab:env:info（Omnibus 包），或访问管理界面的帮助页查看版本。若使用自建/外部数据库，先确认数据库版本兼容性。
• 完整备份：使用内置工具备份数据库、配置与仓库数据。示例：sudo gitlab-rake gitlab:backup:create。如配置了对象存储，也请同步检查备份策略。
• 系统准备：将系统与依赖更新到较新稳定版本，减少升级冲突：sudo apt-get update && sudo apt-get upgrade。
• 维护窗口：单节点升级期间会出现短暂不可用，提前通知用户并选择合适时段。

二 使用 APT 更新 GitLab Omnibus 包（推荐）

• 更新软件源索引：sudo apt-get update。
• 执行升级（CE/EE 二选一）：
  • 社区版：sudo apt-get install --only-upgrade gitlab-ce
  • 企业版：sudo apt-get install --only-upgrade gitlab-ee
• 如希望指定版本（不建议跨多版本）：
  • 查看可用版本：apt-cache madison gitlab-ce（或 gitlab-ee）
  • 指定安装：sudo apt-get install gitlab-ce=<VERSION>（或 gitlab-ee=<VERSION>）
• 使配置生效：sudo gitlab-ctl reconfigure
• 重启服务：sudo gitlab-ctl restart

三 其他部署方式的更新

• Docker 部署：
  • 拉取新镜像：docker pull gitlab/gitlab-ce:latest（或指定具体版本标签）
  • 停止并移除旧容器：docker stop gitlab && docker rm gitlab
  • 使用原有数据卷/挂载目录重新启动：docker run --detach --hostname gitlab.example.com --publish 443:443 --publish 80:80 --publish 22:22 --name gitlab --restart always --volume /srv/gitlab/config:/etc/gitlab --volume /srv/gitlab/logs:/var/log/gitlab --volume /srv/gitlab/data:/var/opt/gitlab gitlab/gitlab-ce:latest
• 源码/非 Omnibus 部署：通常需按官方步骤逐包升级并运行数据库迁移，操作风险较高，建议先在测试环境演练。

四 升级后验证与常见问题

• 版本与健康检查：
  • 访问 Web 管理界面确认版本号与功能正常；
  • 执行健康检查：sudo gitlab-rake gitlab:check SANITIZE=true（Omnibus）。
• 配置与证书：若使用自签名证书或反向代理，升级后复核 /etc/gitlab/gitlab.rb 与 SSL 证书路径、权限是否正确。
• 存储迁移：从旧版本升级到启用哈希存储时，按需执行：gitlab-rake gitlab:storage:migrate_to_hashed。
• 回滚预案：保留上一版本安装包与最近一次备份；若升级失败，先恢复备份，再回退到原版本包。