升级路径

NOTE

重要

本文档介绍 Alauda Container Platform Pipelines Operator 的升级路径原则和支持的版本兼容性。 有关详细的升级说明,请参阅升级 Alauda Container Platform Pipelines Operator。

概述

Alauda Container Platform Pipelines Operator 遵循特定的升级路径原则,以确保版本转换期间的兼容性和稳定性。

版本类型

  • LTS(长期支持)版本:4.0.x、4.2.x、4.6.x、4.10.x、4.14.x - 建议用于生产环境
  • 非 LTS(短期)版本:4.1.x、4.3.x、4.5.x、4.7.x、4.8.x、4.11.x、4.12.x、4.15.x - 用于提前访问功能
  • 发布顺序说明:v4.9 和 v4.13 是有意跳过的版本。v4.8 之后的下一个版本是 v4.10 (LTS),v4.12 之后的下一个版本是 v4.14 (LTS)。

升级原则

  • LTS 版本之间支持升级,支持的最长升级路径最多可跳过两个中间 LTS 版本。例如:
    • 直接 LTS 升级:4.0.x (LTS) → 4.2.x (LTS)
    • 支持的最长升级范围:4.0.x (LTS) → 4.10.x (LTS)(跳过 4.2.x (LTS) 和 4.6.x (LTS))
  • 非 LTS 版本仅支持升级到下一个紧邻的 LTS 版本。例如:
    • 支持 4.3.x → 4.6.x (LTS)
    • 不支持 4.3.x → 4.10.x (LTS)
  • 版本兼容性:同一 minor 版本中的 patch 版本完全兼容
  • 组件一致性:所有 Tekton 组件都会一同升级,以保持兼容性

升级路径

Alauda Container Platform Pipelines v4.15

下表包含此版本回归测试覆盖的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.11.32
4.21.33
4.31.34
pipelines-4.24.11.32
4.21.33
pipelines-4.104.11.32
4.21.33
4.31.34
4.41.35
NOTE

pipelines-4.6、pipelines-4.12 和 pipelines-4.14 在 v4.15.0 发布时仍处于维护期,因此也支持从这些版本升级到 v4.15.x:4.6.x (LTS) 和 4.14.x (LTS) 通过 LTS 升级路径,非 LTS 版本 4.12.x 通过维护路径。它们未列在上表中,因为它们不属于此版本的升级回归测试范围。请参阅升级路径指南,了解适用于每条路径的测试状态。

Alauda Container Platform Pipelines v4.14

下表包含此版本回归测试覆盖的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.11.32
4.21.33
4.31.34
pipelines-4.24.11.32
4.21.33
pipelines-4.104.11.32
4.21.33
4.31.34
NOTE

pipelines-4.6、pipelines-4.11 和 pipelines-4.12 在 v4.14.0 发布时仍处于维护期,因此也支持从这些版本升级到 v4.14.x:4.6.x (LTS) 通过 LTS-to-LTS 扩展路径,非 LTS 版本 4.11.x 和 4.12.x 通过维护路径。它们未列在上表中,因为它们不属于此版本的升级回归测试范围。请参阅升级路径指南,了解适用于每条路径的测试状态。

Alauda Container Platform Pipelines v4.12

下表包含完整的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.11.32
4.21.33
4.31.34
pipelines-4.24.11.32
4.21.33
pipelines-4.64.11.32
4.21.33
pipelines-4.104.11.32
4.21.33
4.31.34
pipelines-4.114.11.32
4.21.33
4.31.34

Alauda Container Platform Pipelines v4.11

下表包含完整的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.11.32
4.21.33
4.31.34
pipelines-4.24.11.32
4.21.33
pipelines-4.64.11.32
4.21.33
pipelines-4.84.11.32
4.21.33
pipelines-4.104.11.32
4.21.33
4.31.34

Alauda Container Platform Pipelines v4.10

下表包含完整的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.01.31
4.11.32
4.21.33
4.31.34
pipelines-4.24.01.31
4.11.32
4.21.33
pipelines-4.64.01.31
4.11.32
4.21.33
pipelines-4.74.01.31
4.11.32
4.21.33
pipelines-4.84.01.31
4.11.32
4.21.33

Alauda Container Platform Pipelines v4.8

下表包含完整的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.01.31.12
4.11.32.7
pipelines-4.24.01.31.12
4.11.32.7
pipelines-4.64.01.31.12
4.11.32.7
4.21.33.6
pipelines-4.74.01.31.12
4.11.32.7
4.21.33.6

Alauda Container Platform Pipelines v4.7

下表包含完整的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.01.31.12
4.11.32.7
pipelines-4.24.01.31.12
4.11.32.7
pipelines-4.34.01.31.12
4.11.32.7
pipelines-4.44.01.31.12
4.11.32.7
pipelines-4.64.01.31.12
4.11.32.7
4.21.33.6

Alauda Container Platform Pipelines v4.6

下表包含完整的升级路径。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.01.31.12
4.11.32.7
pipelines-4.24.01.31.12
4.11.32.7
pipelines-4.34.01.31.12
4.11.32.7
pipelines-4.44.01.31.12
4.11.32.7

Alauda Container Platform Pipelines v4.4.0

此升级路径已使用 Alauda Container Platform Pipelines Operator v4.4.0 版本以及 ACP 版本 4.0.5、4.1.2 进行测试(测试期间可用的最新 LTS patch 版本)。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.0.51.31.12
4.1.21.32.7
pipelines-4.14.0.51.31.12
4.1.21.32.7
pipelines-4.24.0.51.31.12
4.1.21.32.7
pipelines-4.34.0.51.31.12
4.1.21.32.7

Alauda Container Platform Pipelines v4.3.0

此升级路径已使用 Alauda Container Platform Pipelines Operator v4.3.0 版本以及 ACP 版本 4.0.4、4.1.1 进行测试(测试期间可用的最新 LTS patch 版本)。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.0.41.31.6
4.1.11.32.7
pipelines-4.14.0.41.31.6
4.1.11.32.7
pipelines-4.24.0.41.31.6
4.1.11.32.7

Alauda Container Platform Pipelines v4.2.0

此升级路径已使用 Alauda Container Platform Pipelines Operator v4.2.0 版本以及 ACP 版本 4.0.3、4.1.0 进行测试(测试期间可用的最新 LTS patch 版本)。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.0.31.31.6
4.1.01.32.7
pipelines-4.14.0.31.31.6
4.1.01.32.7

Alauda Container Platform Pipelines v4.1.0

此升级路径已使用 Alauda Container Platform Pipelines Operator v4.1.0 版本以及 ACP 版本 4.0.3 进行测试(测试期间可用的最新 LTS patch 版本)。

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.0.31.31.6

前置条件

在开始升级之前,请确保满足以下条件:

  1. 版本兼容性:当前版本位于受支持的升级路径中。
  2. 组件健康状态:所有 Tekton 组件均处于 Ready 状态。
  3. 资源可用性:集群具有足够的资源来支持升级过程。

升级路径指南

LTS 到 LTS 的升级路径

对于生产环境,建议在 Long-Term Support(LTS)版本之间进行升级。我们支持以下所述的标准升级路径和扩展升级路径:

  • 主要路径:上一个 LTS → 当前 LTS

    • 描述:直接从紧邻的上一个 LTS 版本进行升级。
    • 测试状态:已测试所有补丁版本;最新补丁版本会接受全面的回归测试。
    • 示例:4.10.x (LTS) → 4.14.x (LTS)
  • 扩展路径:最多落后两个 LTS 版本 → 当前 LTS

    • 描述:跳过最多两个中间 LTS 版本的直接升级路径。
    • 测试状态:已测试所有补丁版本;最新补丁版本已通过扩展测试进行验证。
    • 示例:4.0.x (LTS) → 4.10.x (LTS)(跳过 4.2.x (LTS) 和 4.6.x (LTS))
  • 维护路径:非 LTS(仍在维护中)→ 当前 LTS

    • 描述:直接从仍处于积极维护阶段的非 LTS 版本进行升级。
    • 测试状态:测试范围有限;理论上受支持。
    • 使用场景:适用于希望从非 LTS 环境直接升级,同时保持在支持范围内的团队。

升级到非 LTS 版本

升级到非 LTS 版本时,需要更快获取新功能的环境可以使用以下路径:

  • 主要路径:上一个 LTS → 当前非 LTS

    • 描述:直接从最新的 LTS 版本进行升级。
    • 测试状态:已测试所有补丁版本;最新补丁版本会接受全面的回归测试。
    • 示例:4.10.x (LTS) → 4.12.x (non-LTS)
  • 扩展路径:落后两个 LTS 版本 → 当前非 LTS

    • 描述:跳过最多两个中间 LTS 版本的直接升级路径。
    • 测试状态:已测试所有补丁版本;最新补丁版本会接受全面的回归测试。
    • 使用场景:适用于希望尽量减少升级跳数的用户。
    • 示例:4.0.x (LTS) → 4.7.x (non-LTS)(跳过 4.2.x (LTS) 和 4.6.x (LTS))
  • 维护路径:非 LTS(仍在维护中)→ 当前非 LTS

    • 描述:适用于仍受支持的非 LTS 版本的升级路径。
    • 测试状态:测试范围有限;理论上受支持。
    • 使用场景:适用于希望快速采用非 LTS 版本新功能的团队。

补丁级别兼容性

  • 同一小版本内:补丁升级(例如 4.0.1 → 4.0.3)完全兼容。
  • 测试策略:支持同一小版本内所有补丁版本之间的升级。最新补丁版本会接受全面的回归测试,而较早的补丁版本仅接受有限测试。
  • 建议:为确保生产环境的稳定性,建议在开始任何大版本或小版本升级之前,先升级到最新的补丁版本。
  • 示例:虽然 4.0.1、4.0.2 和 4.0.3 都可能符合升级到 4.1.x 的条件,但只有最新版本(4.0.3)经过了完整测试和验证。

升级流程参考

如需完整的升级说明,包括分步操作流程、备份指南和故障排除,请参阅: