温馨提示×

linux gitlab怎样升级

小樊
43
2026-09-10 10:55:21
栏目: 智能运维

在 Linux 上升级 GitLab,常见有 Omnibus 安装(最常用)、Docker 安装、源码安装 三种方式。下面按最常见情况说明。


一、Omnibus 方式(官方包安装,推荐)

1. 备份(非常重要)

sudo gitlab-rake gitlab:backup:create

同时备份配置文件:

sudo cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak
sudo cp -R /etc/gitlab/ssl /etc/gitlab/ssl.bak  # 如有

2. 查看当前版本

sudo gitlab-rake gitlab:env:info

或

cat /opt/gitlab/version-manifest.txt

3. 升级原则(很关键)

不能跨大版本直接升 例如:

  • 14.0 → 14.9 → 15.0 → 15.11 → 16.0
  • 不能 14.x 直接升 16.x

4. Debian / Ubuntu

sudo apt update
sudo apt install gitlab-ee   # 或 gitlab-ce

指定版本:

sudo apt install gitlab-ee=16.11.0-ee.0

5. CentOS / RHEL

sudo yum update
sudo yum install gitlab-ee

或

sudo yum install gitlab-ee-16.11.0-ee.0

6. 重新配置并重启

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

二、Docker 方式

1. 查看当前版本

docker ps

2. 拉取新版本镜像

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

3. 停止并删除旧容器(数据在卷中)

docker stop gitlab
docker rm gitlab

4. 用原参数重新运行

docker run -d \
  --name gitlab \
  -p 80:80 -p 443:443 -p 22:22 \
  -v gitlab-config:/etc/gitlab \
  -v gitlab-logs:/var/log/gitlab \
  -v gitlab-data:/var/opt/gitlab \
  gitlab/gitlab-ee:16.11.0-ee.0

升级时会自动执行 migrations


三、升级注意事项(很重要)

✅ 必须看官方升级路径

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

✅ 大版本升级前

  • 看 Release Notes
  • 停掉 CI Runner
  • 确保磁盘空间充足(≥磁盘 2 倍)

✅ 常见问题

  • PostgreSQL 自动升级(不可回退)
  • 15+ 不再支持某些旧配置
  • 16+ 需要 Linux 内核较新

四、升级后检查

sudo gitlab-rake gitlab:check
sudo gitlab-ctl status

如果你愿意,可以告诉我:

  • GitLab 版本(如 14.3 / 15.11)
  • 安装方式(Omnibus / Docker / 源码)
  • 操作系统(Ubuntu 20.04 / CentOS 7 等)

我可以给你精确升级步骤。

0 踩