ubuntu gitlab更新步骤

Ubuntu系统上GitLab更新步骤

一、升级前准备工作

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

   gitlab-rake gitlab:backup:create
   

   备份文件默认存储在/var/opt/gitlab/backups目录下。
2. 检查当前版本：确认当前GitLab版本，确保符合升级路径要求。可通过以下命令查看：

   sudo gitlab-rake gitlab:env:info
   

   或访问GitLab管理界面的“帮助”页面查看版本信息。
3. 阅读官方文档：访问GitLab官方发布说明，确认目标版本的升级要求（如依赖项、兼容性），避免跳过必要中间版本（如从11.0.x升级到11.11.x，再到12.0.x等）。
4. 系统更新：确保Ubuntu系统和现有GitLab组件为最新状态，减少升级冲突：

   sudo apt update && sudo apt upgrade -y
   

二、添加GitLab官方软件源（若未使用Omnibus安装）

若GitLab是通过源码或其他方式安装，需先添加官方软件源以获取最新版本：

1. 导入GPG密钥：验证软件包完整性：

   curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
   

2. 添加软件源（以Ubuntu 20.04为例，其他版本替换$(lsb_release -cs)）：
   • 社区版（CE）：

     echo "deb https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab_gitlab-ce.list
     

   • 企业版（EE）：

     echo "deb https://packages.gitlab.com/gitlab/gitlab-ee/ubuntu/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab_gitlab-ee.list
     

3. 更新软件包索引：

   sudo apt update
   

三、执行GitLab更新

1. 使用Omnibus安装的GitLab（推荐方式）

Omnibus安装包会自动处理依赖关系，更新步骤更简便：

# 更新软件包索引
sudo apt update
# 升级GitLab（社区版）
sudo apt upgrade gitlab-ce
# 若为企业版，将“gitlab-ce”替换为“gitlab-ee”

2. 手动下载包升级（非Omnibus方式）

若通过手动下载.deb包安装，需执行以下步骤：

# 下载目标版本.deb包（以gitlab-ce为例）
wget https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu/pool/main/g/gitlab-ce/gitlab-ce_<version>_amd64.deb
# 安装包并修复依赖
sudo dpkg -i gitlab-ce_<version>_amd64.deb
sudo apt-get install -f

四、重新配置与重启服务

更新完成后，需重新配置GitLab并重启服务，使更改生效：

# 重新配置GitLab（应用配置文件变更）
sudo gitlab-ctl reconfigure
# 重启GitLab服务（确保所有组件更新完成）
sudo gitlab-ctl restart

五、验证升级结果

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

   sudo gitlab-rake gitlab:env:info
   

2. 访问Web界面：打开浏览器，访问GitLab服务器IP或域名，登录后检查功能是否正常（如项目创建、代码推送）。
3. 查看服务状态：确保所有GitLab组件（nginx、unicorn、sidekiq等）运行正常：

   sudo gitlab-ctl status
   

注意事项

• 停机时间：单节点GitLab升级过程中，服务会短暂不可用（通常几分钟），建议在低峰期操作。
• 升级路径：严格遵循GitLab官方升级路径（如小版本→小版本→大版本），避免跨大版本直接升级导致兼容性问题。
• Gitaly升级：若使用Gitaly（分布式存储服务），需先升级Gitaly到兼容版本，再升级GitLab应用层。
• 故障排查：若升级后出现问题，可通过以下命令查看日志：

  sudo gitlab-ctl tail  # 实时查看GitLab日志
  sudo gitlab-rake gitlab:check  # 检查配置问题