升级路径

NOTE

重要

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

概述

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

版本类型

  • LTS(Long-Term Support)版本:4.0.x、4.2.x、4.6.x、4.10.x - 推荐用于生产环境
  • Non-LTS(Short-term)版本:4.1.x、4.3.x、4.5.x、4.7.x、4.8.x - 用于提前获取新特性
  • 发布顺序说明:v4.9 被有意跳过。v4.8 之后的下一个发布版本是 v4.10 (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))
  • 从 Non-LTS 版本升级时,仅支持升级到下一个紧邻的 LTS 版本。例如:
    • 4.3.x → 4.6.x (LTS) 支持
    • 4.3.x → 4.10.x (LTS) 不支持
  • 版本兼容性:同一 minor version 内的 patch version 完全兼容
  • 组件一致性:所有 Tekton 组件会一起升级,以保持兼容性

升级路径

Alauda DevOps 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 DevOps 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 DevOps 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 DevOps 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 DevOps 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 DevOps Pipelines v4.4.0

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

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 DevOps Pipelines v4.3.0

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

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 DevOps Pipelines v4.2.0

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

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 DevOps Pipelines v4.1.0

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

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

前提条件

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

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

升级路径指南

LTS 到 LTS 升级路径

建议在生产环境中进行长期支持版本(LTS)之间的升级。我们支持标准升级路径和扩展升级路径,如下所述:

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

    • 说明:从紧邻的上一个 LTS 版本直接升级。
    • 测试状态:已测试所有 patch version;最新 patch version 会进行全面回归测试。
    • 示例:4.0.x (LTS) → 4.2.x (LTS)
  • 扩展路径:最多回退两个 LTS 版本 → 当前 LTS

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

    • 说明:从仍在主动维护中的 Non-LTS 版本直接升级。
    • 测试状态:测试范围有限;理论上受支持。
    • 适用场景:适用于希望直接从 Non-LTS 环境升级,同时仍保持在支持范围内的团队。

升级到 Non-LTS 版本

当升级到 Non-LTS 发布版本时,对于需要更快获取新特性的环境,可使用以下路径:

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

    • 说明:从最新的 LTS 版本直接升级。
    • 测试状态:已测试所有 patch version;最新 patch version 会进行全面回归测试。
    • 示例:4.10.x (LTS) → 4.11.x (non-LTS)
  • 扩展路径:前两个 LTS 版本 → 当前 Non-LTS

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

    • 说明:适用于仍受支持的 Non-LTS 版本的升级路径。
    • 测试状态:测试范围有限;理论上受支持。
    • 适用场景:适用于快速采用 Non-LTS 发布中新特性的团队。

Patch 级别兼容性

  • 同一 minor version 内:patch 升级(例如 4.0.1 → 4.0.3)完全兼容。
  • 测试策略:同一 minor version 内的所有 patch version 均支持升级。最新 patch version 会经过全面回归测试,而较早的 patch version 仅进行有限测试。
  • 建议:为确保生产环境稳定性,建议在执行任何 major 或 minor version 升级之前,先升级到最新的 patch release。
  • 示例:虽然 4.0.1、4.0.2 和 4.0.3 都可能有资格升级到 4.1.x,但只有最新的 4.0.3 经过了完整测试和验证。

升级流程参考

有关完整的升级说明,包括逐步操作、备份指导和故障排查: