升级GitLab版本的步骤与方法
内容提要
GitLab是企业级软件，升级需按官方提供的逐级升级方案进行，确认升级方式和流程，备份数据。单节点安装导致用户不可用，多节点安装需执行零停机升级。升级步骤包括下载安装包和升级新版本。
延伸解读
升级路径必须逐级进行
GitLab 不能直接跳过主要版本升级，例如从 10.3 直接到 12.7 是不可行的。官方提供了逐级升级方案，以弥补版本跨度过大导致的问题。本文示例中，从 14.8.2 升级到 15.0.0，需要先升级到 14.10.3，再升级到 15.0.0。因此，规划升级时务必确认中间版本，避免因跳版导致升级失败。
备份是升级前的必要步骤
升级前必须备份数据，包括数据库、所有存储库和附件。GitLab 提供了命令行界面备份整个实例，涵盖数据库、附件、Git 存储库数据、CI/CD 作业输出日志、作业工件、LFS 对象、Terraform 状态、容器注册表映像、GitLab 页面内容、包、片段和组 wiki 等。注意，备份只能恢复到与创建它的 GitLab 完全相同的版本和类型（CE/EE），且不会备份未存储在文件系统上的项目以及配置文件（如 /etc/gitlab/gitlab.rb），这些需要单独备份。
单节点与多节点升级的影响不同
对于单节点安装，GitLab 在升级过程中对用户不可用，用户的 Web 浏览器会显示 Deploy in progress 消息或 502 错误。这意味着升级需要安排在业务低峰期进行，并提前通知用户。对于多节点安装，则需要执行零停机升级，具体方法需参考官方文档。因此，在升级前应明确自己的部署架构，评估升级对用户的影响。
升级方式需与安装方式一致
本文环境中 GitLab 通过 RPM 方式安装，版本为 gitlab-ce-14.8.2，因此升级也选择通过 RPM 方式。升级步骤包括下载安装包和升级新版本，分为两个阶段：先升级到 14.10.3，再升级到 15.0.0。完成升级后需检查版本。确保升级方式与安装方式一致，可以避免因方式不匹配导致的问题。
Q&A
如何确认GitLab的升级方式？
需要确认当前安装方式，例如通过RPM方式安装，并选择相同的方式进行升级。
GitLab升级前需要备份哪些数据？
需要备份数据库、所有存储库和附件，确保备份与当前GitLab版本相同。
单节点安装GitLab在升级过程中会出现什么情况？
用户在升级过程中不可用，浏览器会显示Deploy in progress消息或502错误。
GitLab的升级步骤是什么？
升级步骤包括确认升级方式、备份数据、下载安装包和升级新版本，分为两个阶段：14.10.3和15.0.0。
多节点安装GitLab如何进行零停机升级？
多节点安装需参考相关文档，确保在升级过程中不影响用户使用。
GitLab升级后如何检查版本？
完成升级后，需要检查当前的GitLab版本以确认升级成功。
