GitLab在Debian上如何进行系统升级

Debian上GitLab升级操作指南

一 升级前准备

• 明确安装方式与版本：确认是 Omnibus 包（gitlab-ce/gitlab-ee） 还是 Docker 部署，并查看当前版本，例如：sudo gitlab-rake gitlab:env:info。
• 完整备份：优先执行备份，包含数据库与配置，建议将备份文件拷贝到实例外存储。命令示例：sudo gitlab-backup create。
• 检查系统状态：确认磁盘空间、数据库服务可用，并安排维护窗口（单节点升级期间会短暂不可用）。
• 升级系统软件包：sudo apt update && sudo apt upgrade，确保依赖处于健康状态。

二 升级步骤

• Omnibus 包方式（推荐）
  1. 更新软件源并查看可用版本：sudo apt update，apt-cache madison gitlab-ce（或 gitlab-ee）。
  2. 执行升级（两种做法，二选一）：
     • 直接升级到仓库最新版：sudo apt install gitlab-ce（或 gitlab-ee）。
     • 指定版本升级：sudo apt install gitlab-ce=<VERSION>（或 gitlab-ee=<VERSION>）。
  3. 重新配置并重启：sudo gitlab-ctl reconfigure，随后 sudo gitlab-ctl restart。
  4. 验证：sudo gitlab-rake gitlab:check，并访问 Web 管理界面确认版本号。
• Docker 方式
  1. 拉取新镜像：docker pull gitlab/gitlab-ce:latest（或指定版本标签）。
  2. 停止并移除旧容器（数据卷请提前确认挂载与备份）：docker stop gitlab && docker rm gitlab。
  3. 以原有参数重新启动新容器（示例）：
     docker run --name gitlab -p 80:80 -p 443:443 -p 22:22 -d gitlab/gitlab-ce:latest。
  4. 访问页面确认升级结果。

三 升级后验证与常见问题

• 版本与连通性：在管理界面或命令行确认版本；检查 Unicorn/ Puma、Sidekiq、Nginx 等服务是否正常运行（sudo gitlab-ctl status）。
• 数据完整性：如从旧版本迁移到启用哈希存储，按需执行：sudo gitlab-rake gitlab:storage:migrate_to_hashed。
• 配置与日志：核对 /etc/gitlab/gitlab.rb 变更是否生效，查看 /var/log/gitlab/ 下相关日志定位异常。
• glibc 相关：若底层 glibc 有较大版本变动，升级前后务必复核 PostgreSQL 数据一致性与可用性。

四 自动化与安全建议

• 启用无人值守升级：安装并启用 unattended-upgrades，定期自动应用安全更新。
  • 安装：sudo apt install unattended-upgrades -y
  • 启用：sudo dpkg-reconfigure unattended-upgrades（选择 Yes）
  • 检查计划任务：sudo systemctl status apt-daily.timer、sudo systemctl status apt-daily-upgrade.timer
  • 模拟运行：sudo unattended-upgrade --dry-run
• 变更管理：升级前在测试环境演练，生产环境按版本路径逐步升级，保留回滚方案与完整备份。