Linux环境下GitLab如何更新

Linux环境下GitLab更新步骤

1. 前置准备：备份数据

在进行任何升级操作前，必须备份GitLab所有关键数据（包括仓库代码、CI/CD配置、数据库、用户信息等），以防止升级过程中出现数据丢失。常用备份命令为：
sudo gitlab-rake gitlab:backup:create
该命令会生成一个包含所有数据的备份文件，默认存储在/var/opt/gitlab/backups目录下。

2. 确认当前版本与升级路径

• 查看当前版本：通过GitLab管理界面（右上角头像→Settings→General）或命令行获取：
  sudo gitlab-rake gitlab:env:info
• 选择目标版本：参考GitLab官方发布的升级路径指南，确保当前版本与目标版本之间的兼容性（如从16.0升级到17.0需经过中间版本过渡）。

3. 停止GitLab相关服务

为避免升级过程中服务冲突，需停止GitLab的核心服务：
sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq
sudo gitlab-ctl stop nginx
（注：部分场景下可能需要停止更多服务，具体以官方文档为准）。

4. 更新GitLab包

根据GitLab的安装方式（Omnibus或RPM/Docker），选择对应的更新方法：

（1）Omnibus安装（主流方式，适用于Debian/Ubuntu/CentOS等）

• 更新包索引：
  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
  （Omnibus安装会自动处理依赖关系和配置文件的合并）。

（2）RPM包手动安装

• 下载新版本RPM包：从GitLab官方下载页面获取与系统架构匹配的包（如gitlab-ce-17.0.0.el7.x86_64.rpm）。
• 移除旧版本：sudo yum remove gitlab-ce（可选，但建议清理旧版本以避免冲突）。
• 安装新版本：sudo yum install /path/to/gitlab-ce-*.rpm。

（3）Docker容器部署

• 停止并删除旧容器：
  docker-compose down -v（若使用docker-compose）或docker stop gitlab && docker rm gitlab。
• 拉取最新镜像：docker pull gitlab/gitlab-ce:latest（或指定具体版本标签，如gitlab/gitlab-ce:17.0.0）。
• 启动新容器：使用与旧容器一致的配置文件（如docker-compose.yml）启动：
  docker-compose up -d（或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）。

5. 重新配置与重启GitLab

• 重新配置：Omnibus安装需运行sudo gitlab-ctl reconfigure，以应用配置文件的修改（如自定义路径、端口等）；Docker部署无需此步骤（配置已在容器启动时加载）。
• 重启服务：Omnibus安装用sudo gitlab-ctl restart重启所有服务；Docker部署通过docker-compose restart或docker restart gitlab重启容器。

6. 验证更新结果

• 检查版本：通过GitLab管理界面（首页右下角）或命令行确认版本：
  sudo gitlab-rake gitlab:check（该命令还会检查系统状态是否正常）。
• 测试功能：登录GitLab，创建测试项目、触发CI/CD流水线，确保核心功能正常。

注意事项

• 测试环境优先：生产环境升级前，务必在测试环境模拟整个流程，避免影响线上业务。
• 依赖问题处理：若升级过程中出现依赖错误，需根据提示安装缺失的库（如libicu、postgresql等），或调整系统包版本。
• Docker注意事项：升级后需检查容器卷挂载路径（如/srv/gitlab/config、/srv/gitlab/data）是否正确，避免数据丢失；若使用自定义配置（如GITLAB_OMNIBUS_CONFIG），需同步更新docker-compose.yml文件。