GitLab在Debian上的版本更新流程是怎样的

Debian 上 GitLab 版本更新流程

一 标准升级流程 Omnibus 包

• 备份与检查
  • 执行完整备份：sudo gitlab-rake gitlab:backup:create
  • 查看当前版本：sudo gitlab-rake gitlab:env:info
  • 规划升级路径：跨主版本升级需按官方升级路径分步进行，先在测试环境验证
• 准备与更新软件源
  • 导入仓库 GPG 密钥：curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
  • 添加官方仓库（CE/EE 二选一）：
    • CE：sudo add-apt-repository 'deb https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu $(lsb_release -cs) main'
    • EE：sudo add-apt-repository 'deb https://packages.gitlab.com/gitlab/gitlab-ee/ubuntu $(lsb_release -cs) main'
  • 更新索引：sudo apt-get update
• 执行升级
  • 查看可用版本：apt-cache madison gitlab-ce（EE 将 ce 替换为 ee）
  • 安装指定版本：sudo apt-get install gitlab-ce=<version>（EE 使用 gitlab-ee=<version>）
• 重新配置与重启
  • 重新配置：sudo gitlab-ctl reconfigure
  • 重启服务：sudo gitlab-ctl restart
• 验证
  • 访问 Web 管理界面确认版本号
  • 运行健康检查：sudo gitlab-rake gitlab:check

二 可选方式

• 使用官方安装脚本
  • 一键配置仓库并安装/升级：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash，随后 sudo apt-get install gitlab-ce（或 gitlab-ee）
• 使用 .deb 包离线安装
  • 下载对应版本的 .deb 包后安装：sudo dpkg -i gitlab-ce_<version>_amd64.deb
  • 若有依赖问题：sudo apt-get install -f
  • 然后执行：sudo gitlab-ctl reconfigure 与 sudo gitlab-ctl start
• 使用 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

三 注意事项与常见问题

• 升级前务必完成完整备份，并在测试环境验证；单节点升级会有短暂不可用
• 跨主版本升级需遵循官方升级路径，避免直接跳级导致数据/组件不兼容
• 升级后执行 sudo gitlab-ctl reconfigure 使新配置生效；必要时再 restart
• 访问 Web 端确认版本与健康状态，必要时运行 sudo gitlab-rake gitlab:check 做进一步校验
• 若使用自签名证书，升级后可能需要重新配置 SSL