升级路径

一次性跨越多个 GitLab 版本升级只能通过接受停机时间来实现。 如果您不希望有任何停机时间，请阅读如何进行零停机升级。

升级路径包含必需的升级停顿点，这些是您在升级到后续版本之前必须升级到的 GitLab 版本。当沿着升级路径进行时：

1. 升级到当前版本之后的必需升级停顿点。
2. 允许升级的后台迁移完成。
3. 升级到下一个必需的升级停顿点。

为了给实例管理员提供可预测的升级计划，从 GitLab 17.5 开始，必需的升级停顿点将出现在 x.2.z、x.5.z、x.8.z 和 x.11.z 版本。

要确定您的升级路径：

1. 记录您当前版本在升级路径中的位置，包括必需的升级停顿点：

   • GitLab 15 包含以下必需的升级停顿点：
     • 15.0.5。
     • 15.1.6。具有多个 Web 节点的 GitLab 实例。
     • 15.4.6。
     • 15.11.13。
   • GitLab 16 包含以下必需的升级停顿点：
     • 16.0.10。具有大量用户或大型流水线变量历史记录的实例。
     • 16.1.8。其包注册表中包含 NPM 包的实例。
     • 16.2.11。具有大型流水线变量历史记录的实例。
     • 16.3.9。
     • 16.7.10。
     • 16.11.10。
   • GitLab 17 包含以下必需的升级停顿点：
     • 17.1.8。具有大型 ci_pipeline_messages 表的实例。
     • 17.3.7。最新的 GitLab 17.3 版本。
     • 17.5.z。最新的 GitLab 17.5 版本。
     • 17.8.z。最新的 GitLab 17.8 版本。
     • 17.11.z。最新的 GitLab 17.11 版本。

2. 查看特定版本的升级说明：

   • GitLab 18 changes
   • GitLab 17 changes
   • GitLab 16 changes
   • GitLab 15 changes

即使没有明确说明，也应将 GitLab 升级到 major.minor 版本的最新可用补丁版本，而不是第一个补丁版本。例如，升级到 16.8.7 而不是 16.8.0。

这包括您在升级路径上必须停顿的 major.minor 版本，因为可能包含与升级过程相关问题的修复。 特别是在主要版本附近，最新的补丁版本中可能包含关键的数据库架构和迁移补丁。

升级路径工具

要根据您当前的 GitLab 版本和期望的目标版本快速计算需要哪些升级停顿点，请查看升级路径工具。该工具由 GitLab 支持团队维护。

要分享反馈并帮助改进该工具，请在升级路径项目中创建问题或合并请求。

早期 GitLab 版本

有关升级到早期 GitLab 版本的信息，请参阅文档存档。存档中的文档版本包含更早版本的 GitLab 的特定版本信息。

例如，GitLab 15.11 的文档包含回溯到 GitLab 12 版本的信息。