极狐GitLab 17.4 升级指南

GitLab 是一个全球知名的一体化 DevOps 平台，很多人都通过私有化部署 GitLab 来进行源代码托管。极狐GitLab https://dl.gitlab.cn/6y2wxugm 是 GitLab 在中国的发行版，专门为中国程序员服务。可以一键式部署极狐GitLab。

本文分享极狐GitLab 17.4 升级的详细步骤。

今日，极狐GitLab 17.4 正式发布。新版本发布了几十项与 DevSecOps 相关的更新，包括项目管理、源代码托管、CI/CD、安全合规等。对于用户来讲及时升级到最新版本不仅能够第一时间体验到最新功能，更重要的是能够避免老旧版本存在的安全风险而遭受安全攻击。

不同的安装方式有不同的升级方式：

Omnibus 安装

不同操作系统，升级命令不同：

# Ubuntu
apt install gitlab-jh

# RHEL/CentOS 7
yum update gitlab-jh

# AlmaLinux 8
dnf update gitlab-jh

Docker 安装

升级容器镜像即可，17.4 的容器镜像为：

registry.gitlab.cn/omnibus/gitlab-jh:17.4.0-jh.0

Helm Chart 安装

找到对应的 Helm Chart 版本，用 helm upgrade升级即可：
helm search repo gitlab-jh
NAME                       CHART VERSION    APP VERSION    
gitlab-jh/gitlab           8.4.0            v17.4.0

下面以 Omnibus 安装的版本为例演示升级到 17.4 的过程。

首先，确认当前实例的版本，可以用多种方式来确认：

通过实例 URL/help 来查看，比如 jihu-gitlab.example.com/help；
在管理中心的的概览仪表盘中查看；
直接用命令行来查看

本文用命令行来查看，因为安装操作系统为 Ubuntu 220.4，因此使用 apt policy gitlab-jh 查看：

apt policy gitlab-jh
gitlab-jh:
  Installed: 17.3.0-jh.0
  Candidate: 17.4.0-jh.0

可以看到当前安装的为极狐GitLab 17.3 版本，候选版本即为最新版本 17.4。由于版本差别不大，直接升级即可。不过在升级之前要做好数据备份：

$ gitlab-backup create

2024-09-25 08:20:44 UTC -- Dumping database ...
2024-09-25 08:20:44 UTC -- Dumping PostgreSQL database gitlabhq_production ...
2024-09-25 08:21:15 UTC -- [DONE]
2024-09-25 08:21:15 UTC -- Dumping database ... done
2024-09-25 08:21:15 UTC -- Dumping repositories ...

.......太长，删除......
2024-09-25 08:21:15 UTC -- Warning: Your gitlab.rb and gitlab-secrets.json files contain sensitive data
and are not included in this backup. You will need these files to restore a backup.
Please back them up manually.
2024-09-25 08:21:15 UTC -- Backup 1727252443_2024_09_25_17.3.0-jh is done.
2024-09-25 08:21:15 UTC -- Deleting backup and restore PID file at [/opt/gitlab/embedded/service/gitlab-rails/tmp/backup_restore.pid] ... done

查看备份文件：

ls -ltr /var/opt/gitlab/backups/
total 702280
-rw------- 1 git git 352256000 Aug 19 08:02 1724054494_2024_08_19_17.2.2-jh_gitlab_backup.tar
-rw------- 1 git git 366878720 Sep 25 08:21 1727252443_2024_09_25_17.3.0-jh_gitlab_backup.tar

可以看到有 17.3 对应的备份版本 1727252443_2024_09_25_17.3.0-jh_gitlab_backup.tar。

接下来直接用 apt update && apt install gitlab-jh升级即可：