ubuntu gitlab如何更新

Ubuntu系统下GitLab更新指南（以Omnibus安装为例）

一、更新前准备

1. 备份关键数据
   升级前必须备份GitLab的所有核心数据（数据库、项目文件、配置文件），避免升级失败导致数据丢失。使用GitLab自带工具执行完整备份：

   sudo gitlab-backup create STRATEGY=copy
   

   备份文件默认存储在/var/opt/gitlab/backups目录，建议将备份文件复制到远程存储（如S3、NAS）。
2. 确认当前版本
   通过以下命令查看当前GitLab版本，明确升级路径（如从14.x升级到16.x需经过中间版本）：

   sudo gitlab-rake gitlab:env:info
   # 或
   cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
   

二、系统及软件源更新

1. 更新Ubuntu系统包
   确保系统处于最新状态，避免依赖冲突：

   sudo apt update && sudo apt upgrade -y && sudo reboot
   

2. 添加/更新GitLab官方仓库
   若未添加GitLab仓库，执行以下命令添加（社区版为例）：

   curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
   

   若已添加，可直接更新本地软件包索引：

   sudo apt update
   

三、执行GitLab更新

1. 升级GitLab包
   使用APT工具升级GitLab到最新可用版本（社区版命令）：

   sudo apt install gitlab-ce
   

   若需指定版本（如升级到16.8.2），可替换为：

   sudo apt install gitlab-ce=<version>
   

   执行后会自动解决依赖关系并下载升级包。
2. 重新配置与重启服务
   升级完成后，运行以下命令应用配置变更并重启GitLab服务：

   sudo gitlab-ctl reconfigure  # 重新生成配置文件（如nginx、postgresql）
   sudo gitlab-ctl restart      # 重启所有GitLab组件（unicorn、sidekiq、nginx）
   

四、验证更新结果

1. 检查版本信息
   通过命令确认GitLab已升级至目标版本：

   sudo gitlab-rake gitlab:env:info
   # 或访问Web界面（http://your-server-ip），在“帮助”页面查看版本
   

2. 测试核心功能
   登录GitLab Web界面，创建测试项目、提交代码、触发CI/CD流水线，确保所有功能正常运行。

五、Docker部署的特殊更新流程

若使用Docker运行GitLab，需通过镜像更新：

1. 拉取最新镜像

   docker pull gitlab/gitlab-ce:latest
   

2. 停止并删除旧容器

   docker stop gitlab && docker rm gitlab
   

3. 启动新容器
   使用旧容器的配置文件和数据卷，确保数据一致性：

   docker run --name gitlab -d --restart always \
     -p 80:80 -p 443:443 -p 22:22 \
     -v /srv/gitlab/config:/etc/gitlab \
     -v /srv/gitlab/logs:/var/log/gitlab \
     -v /srv/gitlab/data:/var/opt/gitlab \
     gitlab/gitlab-ce:latest
   

注意事项

• 升级路径：严格遵循GitLab官方升级路径（如14.x→15.x→16.x），避免跨大版本直接升级。
• 停机时间：单节点实例升级期间会有短暂停机（约5-10分钟），建议在低峰期操作。
• 防火墙设置：确保防火墙开放GitLab所需端口（HTTP 80、HTTPS 443、SSH 22）。
• 测试环境验证：生产环境升级前，务必在测试环境模拟升级流程，排查潜在问题。