• 升级路径工具

{{< details >}}

• Tier: 基础版、专业版、旗舰版
• Offering: 私有化部署

{{< /details >}}

跨多个极狐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。极狐GitLab实例具有多个 Web 节点。
     • 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. 尚未发布。

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

   • 极狐GitLab 17 变更
   • 极狐GitLab 16 变更
   • 极狐GitLab 15 变更

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

这包括您必须在升级路径上停留的major.minor版本，因为可能有与升级过程相关的问题修复。

特别是在主要版本周围，关键的数据库架构和迁移补丁可能包含在最新的补丁版本中。

升级路径工具

要快速计算基于您当前和目标极狐GitLab版本所需的升级停靠点，请参阅升级路径工具。