Linux中GitLab的更新如何操作 - 问答

一、升级前的准备工作

备份所有关键数据
升级前必须通过GitLab自带工具创建完整备份，涵盖仓库代码、数据库（如PostgreSQL/MySQL）、CI/CD配置、用户权限等。常用命令：
```
sudo gitlab-rake gitlab:backup:create
```
备份文件默认存储在/var/opt/gitlab/backups目录，建议将备份文件复制到异地或其他存储设备。
确认当前版本与升级路径
- 查看当前GitLab版本的方法：
  - 通过Web界面：登录GitLab，点击右上角头像→「Settings」→「General」→「Version」。
  - 通过命令行：
```
sudo gitlab-rake gitlab:env:info
```
- 参考GitLab官方升级路径指南（如从15.10升级到16.11，需确认中间是否有必经的次要版本），避免跨大版本直接升级导致兼容性问题。
停止GitLab相关服务
升级过程中需停止核心服务，防止数据损坏。常用命令：
```
sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq
sudo gitlab-ctl stop nginx
```
可通过sudo gitlab-ctl status确认服务已全部停止。

二、根据安装方式执行升级

1. Omnibus安装（最常见，适用于Debian/Ubuntu/CentOS/RHEL）

更新包索引：
Debian/Ubuntu系统：
```
sudo apt update
```
CentOS/RHEL系统：
```
sudo yum update
```
升级GitLab包：
Debian/Ubuntu系统：
```
sudo apt upgrade gitlab-ce
```
CentOS/RHEL系统：
```
sudo yum upgrade gitlab-ce
```
重新配置与重启：
升级完成后，重新配置GitLab以应用新设置（如修改过gitlab.rb配置文件需执行此步）：
```
sudo gitlab-ctl reconfigure
```
重启GitLab服务使变更生效：
```
sudo gitlab-ctl restart
```

2. RPM包手动安装

下载新版本RPM包：
从GitLab官方仓库下载对应Linux发行版和架构的最新RPM包（如gitlab-ce-16.11.10-ce.0.el8.x86_64.rpm）。
校验包完整性（可选但推荐）：
使用md5sum或sha256sum核对下载包的哈希值与官方提供的是否一致。
升级包：
```
sudo rpm -Uvh gitlab-ce-*.rpm
```
重新配置与重启：
同Omnibus安装步骤，执行sudo gitlab-ctl reconfigure和sudo gitlab-ctl restart。

3. Docker部署

备份数据卷：
Docker模式下，GitLab数据存储在挂载的卷（如/srv/gitlab/config、/srv/gitlab/logs、/srv/gitlab/data）中，需提前备份这些目录。
停止并删除旧容器：
```
docker stop gitlab
docker rm gitlab
```
拉取最新镜像：
```
docker pull gitlab/gitlab-ce:latest
```

启动新容器：
使用与旧容器相同的配置（如端口映射、卷挂载）启动新容器：

docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

三、升级后验证

检查版本信息：
- 通过Web界面：登录GitLab，查看「Settings」→「General」→「Version」。
- 通过命令行：
```
sudo gitlab-rake gitlab:check
```
  该命令会自动检测GitLab运行状态及版本信息。
测试核心功能：
创建测试项目、提交代码、触发CI/CD pipeline，确认所有功能正常。
清理旧备份：
升级成功后，可删除旧的备份文件以释放存储空间（建议保留最近1-2次备份）。

注意事项

若升级到大版本（如15.x→16.x），需先查阅GitLab官方发布的升级 notes，确认是否有特殊的迁移步骤（如数据库 schema 变更）。
生产环境升级前，务必在测试环境模拟整个流程，避免因配置差异导致问题。
升级过程中若出现依赖冲突，需根据错误提示解决（如安装缺失的库文件）。

0 赞

0 踩