温馨提示×

linux gitlab怎么升级

小樊
51
2026-08-13 08:12:48
栏目: 智能运维

下面分 GitLab 在 Linux 上的升级方式 给你说明,先说结论,再给详细步骤。


一、先确认当前版本(非常重要)

cat /opt/gitlab/version-manifest.txt | head -n 1
# 或
gitlab-rake gitlab:env:info

二、升级路线(必须注意)

GitLab 不能跨大版本直接升级,必须按官方升级路径走。

✅ 官方升级路径查询(强烈推荐)

https://docs.gitlab.com/ee/update/index.html#upgrade-paths

例如:

13.12 → 14.0 → 14.3 → 14.9 → 15.0 → 15.11 → 16.x

三、最常见方式:Omnibus GitLab(官方推荐)

1️⃣ 备份(必须)

gitlab-backup create

备份目录默认:/var/opt/gitlab/backups

⚠️ 还要备份配置文件

cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak
cp -r /etc/gitlab/ssl /etc/gitlab/ssl.bak

2️⃣ 升级 GitLab(以 CentOS / RHEL / Rocky 为例)

查看当前版本

yum list installed | grep gitlab

升级到指定版本(推荐)

yum install gitlab-ee-16.7.0-ee.0.el7.x86_64

或升级到最新版:

yum update gitlab-ee

Ubuntu / Debian

apt update
apt install gitlab-ee=16.7.0-ee.0

3️⃣ 应用配置

gitlab-ctl reconfigure
gitlab-ctl restart

4️⃣ 检查状态

gitlab-ctl status
gitlab-rake gitlab:check SANITIZE=true

四、Docker 方式升级(如果你用的是 Docker)

1️⃣ 停止容器

docker stop gitlab

2️⃣ 拉取新版本

docker pull gitlab/gitlab-ee:16.7.0-ee.0

3️⃣ 重新运行容器(数据目录不变)

docker run -d \
  --name gitlab \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ee:16.7.0-ee.0

五、升级失败常见原因

问题 解决
跨大版本升级 按官方路径逐步升级
PostgreSQL 升级失败 查看 /var/log/gitlab/postgresql
端口冲突 gitlab-ctl reconfigure
磁盘空间不足 至少预留 5GB

六、升级建议(生产环境)

✅ 凌晨升级
✅ 先升级测试环境
✅ 每个大版本升级后观察 1–2 天
✅ 不要跳过 LTS 版本


七、我可以帮你

你可以直接告诉我: 1️⃣ 当前 GitLab 版本
2️⃣ Linux 发行版(CentOS / Ubuntu / Rocky)
3️⃣ 是否是 Docker 部署

我可以 直接给你一条可用的升级命令和路径

0