AI 文章摘要
本文详细介绍了升级GitLab版本的系统化方法,重点强调了官方推荐的逐级升级策略以避免因版本跨度过大导致的升级问题。GitLab升级需通过RPM包管理方式执行,升级路径需遵循当前大版本最高版本到下一版本的顺序,如14.8.2→14.10.3→15.0.0。升级过程中,单节点安装会导致服务不可用,而多节点安装可通过零停机升级实现。升级前必须进行全面备份,包括数据库、存储库、附件、CI/CD工件等,但需注意GitLab不备份配置文件、TLS密钥及系统文件。升级源可选择官方源或清华镜像源。升级成功后需登录GitLab验证版本。整个过程需严格遵循官方升级路径,确保数据安全和系统稳定性。
一、升级说明
GitLab 是一个企业级软件,它所采用了大量的第三方开源组件,它的升级是一个系统化工程。
所幸,GitLab 官方提供了一个稳妥可靠的 逐级 升级方案以弥补由于当前版本与最新版本之间的跨度太大儿无法升级的问题。也就是说GitLab不能直接跳过主要版本(例如,一步从 10.3 转到 12.7)
二、操作步骤
1、确认升级方式
首先,我的环境中GitLab是通过RPM方式安装的,然后版本是gitlab-ce-14.8.2,所以我要进行升级的话还是选择通过RPM的方式去升级。
2、确认升级流程
- GitLab版本发布:https://packages.gitlab.com/gitlab/gitlab-ce
- GitLab的跨版本升级,需要先升级到当前大版本的最高版本后再升到下一版本。因此升级路线如下:
- 官方升级路径:
文章来源(Source):浅时光博客 https://docs.gitlab.com/ee/update/index.html#upgrade-paths
3、确认升级影响
- 对于单节点安装,GitLab 在升级过程中对用户不可用。用户的 Web 浏览器显示Deploy in progress消息或502错误。
- 对于多节点安装,请参阅如何执行 零停机升级
4、升级前备份
- GitLab 提供了用于备份和恢复 GitLab 实例的 Rake 任务。
- 应用程序数据备份会创建一个包含数据库、所有存储库和所有附件的存档文件。
- 您只能将备份恢复到与 创建它的 GitLab完全相同的版本和类型 (CE/EE) 。将项目从一台服务器迁移到另一台服务器的最佳方式是通过备份和恢复。
注意:
(1)GitLab 不会备份未存储在文件系统上的项目。如果您使用的是对象存储,请确保在需要时使用您的对象存储提供程序启用备份。
(2)GitLab 不备份任何配置文件 ( /etc/gitlab)、TLS 密钥和证书或系统文件。强烈建议您阅读有关存储配置文件的信息
GitLab 提供了一个命令行界面来备份您的整个实例,包括:
- 数据库
- 附件
- Git 存储库数据
- CI/CD 作业输出日志
- CI/CD 作业工件
- LFS 对象
- Terraform 状态(在 GitLab 14.7 中 引入)
- 容器注册表映像
- GitLab 页面内容
- 包(在 GitLab 14.7 中 引入)
- 片段
- 组 wiki
#GitLab 12.2 或更高版本:
gitlab-backup create
#GitLab 12.1 及更早版本:
gitlab-rake gitlab:backup:create
#配置文件需要单独备份
/etc/gitlab/gitlab.rb 配置文件须备份
5、开始进行升级
- 官方源:https://packages.gitlab.com/gitlab/gitlab-ce
- 清华源:https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/
5.1:升级到14.10.3版本
#下载安装包
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-14.10.3-ce.0.el7.x86_64.rpm
#升级新版本
rpm -Uvh gitlab-ce-14.10.3-ce.0.el7.x86_64.rpm
5.2:升级到15.0.0版本
#下载安装包
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-15.0.0-ce.0.el7.x86_64.rpm
#升级新版本
rpm -Uvh gitlab-ce-15.0.0-ce.0.el7.x86_64.rpm
三、检查版本
- 最好登入Gitlab检查版本是否升级成功
本文要点
原文摘录- GitLab 官方提供了一个稳妥可靠的 逐级 升级方案以弥补由于当前版本与最新版本之间的跨度太大儿无法升级的问题。也就是说GitLab不能直接跳过主要版本(例如,一步从 10.3 转到 12.7)
- 对于单节点安装,GitLab 在升级过程中对用户不可用。用户的 Web 浏览器显示Deploy in progress消息或502错误。








必须 注册 为本站用户, 登录 后才可以发表评论!