Linux GitLab版本如何升级 - 问答

Linux环境下GitLab版本升级详细步骤

1. 升级前准备工作

1.1 备份所有关键数据

升级前必须备份GitLab的核心数据（仓库、数据库、配置），避免升级失败导致数据丢失。

完整数据备份：使用GitLab自带命令创建包含仓库、上传文件等的备份：
```
sudo gitlab-backup create
```
备份配置文件：gitlab-secrets.json（含加密密钥）和gitlab.rb（主配置文件）需单独复制到安全目录：
```
sudo cp /etc/gitlab/gitlab-secrets.json /backup/location/
sudo cp /etc/gitlab/gitlab.rb /backup/location/
```

1.2 确认当前版本与升级路径

查看当前版本：通过命令行获取详细环境信息（包括版本号）：
```
sudo gitlab-rake gitlab:env:info
```
确定升级路径：若当前版本与目标版本差距较大（如11.0→13.0），需通过GitLab官方升级路径工具获取中间版本序列，避免跨版本升级失败：
GitLab升级路径工具

1.3 检查系统环境

依赖项：确保系统已安装GitLab所需的依赖（如Ruby、PostgreSQL、Redis等），可通过sudo apt update && sudo apt upgrade（Debian/Ubuntu）或sudo yum update（CentOS/RHEL）更新系统包。
资源要求：确认服务器有足够的磁盘空间（建议至少10GB空闲）、内存（至少2GB，推荐4GB以上）。
glibc兼容性：若升级到较新版本（如GitLab 15+），需确保系统glibc版本符合要求（可通过ldd --version查看），避免因库不兼容导致升级失败。

2. 执行升级操作（以Omnibus安装为例）

2.1 停止GitLab相关服务

升级前需停止GitLab核心服务，防止文件锁定或数据损坏：

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq
sudo gitlab-ctl stop nginx

2.2 更新包存储库

确保系统能获取GitLab的最新包版本：

Debian/Ubuntu：添加GitLab官方APT仓库：

curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

CentOS/RHEL：添加GitLab官方YUM仓库（参考GitLab官方文档）。

2.3 升级GitLab包

根据升级路径，逐步安装中间版本（如从11.0→11.1→11.2→13.0），避免跳过版本：

# 示例：升级到指定版本（替换为升级路径中的版本号）
sudo apt-get install -y gitlab-ce=15.2.5-ce.0

注意：若使用RPM包，可通过rpm -Uvh gitlab-ce-<version>.rpm命令升级。

2.4 重新配置与重启服务

重新配置：应用新版本的配置变更（如gitlab.rb中的修改）：
```
sudo gitlab-ctl reconfigure
```
重启服务：启动所有GitLab组件，确保新版本生效：
```
sudo gitlab-ctl restart
```

2.5 Docker方式升级（可选）

若通过Docker运行GitLab，步骤如下：

停止并删除旧容器：
```
docker stop gitlab
docker rm gitlab
```

拉取新镜像：

docker pull gitlab/gitlab-ce:latest  # 或指定目标版本，如gitlab/gitlab-ce:15.2.5-ce.0

启动新容器：使用旧容器的配置文件和数据卷，确保数据一致性：

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

3. 升级后验证

3.1 检查版本信息

Web界面：访问http://your-gitlab-url/help，顶部应显示新版本号。
命令行：运行以下命令确认版本：
```
sudo gitlab-rake gitlab:env:info
```

3.2 运行系统检查

健康检查：执行GitLab自检命令，查看是否有错误或警告：
```
sudo gitlab-rake gitlab:check SANITIZE=true
```
数据库迁移：确保所有数据库迁移已完成：
```
sudo gitlab-rake db:migrate:status  # 所有迁移状态应为“已启动”
```
或通过Web界面检查（管理区域→监控→后台迁移），确保所有后台迁移均为“已完成”。

3.3 验证功能正常

登录GitLab Web界面，创建测试项目、推送代码、触发CI/CD流水线，确认核心功能无异常。

注意事项

逐步升级：若当前版本落后较多（如超过2个大版本），必须逐步升级到中间版本，避免直接跨版本升级导致数据损坏。
日志排查：升级过程中若出现错误，可通过/var/log/gitlab/下的日志文件（如gitlab-rails/production.log）定位问题。
测试环境：生产环境升级前，务必在测试环境中模拟升级流程，确保兼容性。

0 赞

0 踩