Alauda DevOps Pipelines Docs
  • 简体中文

    • 升级路径

    NOTE

    重要

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

    目录

    概述版本类型升级原则升级路径Alauda DevOps Pipelines v4.14Alauda DevOps Pipelines v4.12Alauda DevOps Pipelines v4.11Alauda DevOps Pipelines v4.10Alauda DevOps Pipelines v4.8Alauda DevOps Pipelines v4.7Alauda DevOps Pipelines v4.6Alauda DevOps Pipelines v4.4.0Alauda DevOps Pipelines v4.3.0Alauda DevOps Pipelines v4.2.0Alauda DevOps Pipelines v4.1.0前提条件升级路径指南LTS 到 LTS 的升级路径升级到非 LTS 版本Patch 级兼容性升级流程参考

    概述

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

    版本类型

    • LTS（Long-Term Support）版本：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 - 适用于尽早获取新功能
    • 发布顺序说明：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 DevOps Pipelines v4.14

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

    Channel versionACP versionKubernetes version
    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

    当 v4.14.0 发布时，pipelines-4.6、pipelines-4.11 和 pipelines-4.12 仍处于维护期，因此也支持从它们升级到 v4.14.x：4.6.x (LTS) 可通过 LTS 到 LTS 的扩展路径升级，非 LTS 的 4.11.x 和 4.12.x 可通过维护路径升级。它们未列在上表中，是因为不属于本次 release 的升级回归测试范围。有关适用于各条路径的测试状态，请参阅 升级路径指南。

    Alauda DevOps Pipelines v4.12

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

    Channel versionACP versionKubernetes version
    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 DevOps Pipelines v4.11

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

    Channel versionACP versionKubernetes version
    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 versionACP versionKubernetes version
    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 versionACP versionKubernetes version
    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 versionACP versionKubernetes version
    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 versionACP versionKubernetes version
    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 版本）

    Channel versionACP versionKubernetes version
    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 版本）

    Channel versionACP versionKubernetes version
    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 版本）

    Channel versionACP versionKubernetes version
    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 版本）

    Channel versionACP versionKubernetes version
    pipelines-4.04.0.31.31.6

    前提条件

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

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

    升级路径指南

    LTS 到 LTS 的升级路径

    建议在生产环境中执行 Long-Term Support（LTS）版本之间的升级。我们支持如下所述的标准升级路径和扩展升级路径：

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

      • 说明：从紧邻的上一个 LTS 版本直接升级。
      • 测试状态：所有 patch 版本都已测试；最新 patch 版本会进行全面回归测试。
      • 示例：4.10.x (LTS) → 4.14.x (LTS)

    • 扩展路径：向前追溯最多两个 LTS 版本 → 当前 LTS

      • 说明：可跳过最多两个中间 LTS 版本的直接升级路径。
      • 测试状态：所有 patch 版本都已测试；最新 patch 版本会通过扩展测试进行验证。
      • 示例：4.0.x (LTS) → 4.10.x (LTS)（跳过 4.2.x (LTS) 和 4.6.x (LTS)）

    • 维护路径：非 LTS（仍在维护中）→ 当前 LTS

      • 说明：从仍在积极维护的非 LTS 版本直接升级。
      • 测试状态：测试范围有限；理论上支持。
      • 使用场景：适用于希望直接从非 LTS 环境升级，同时仍保持在支持边界内的团队。

    升级到非 LTS 版本

    当升级到非 LTS release 时，对于需要更快获取新功能的环境，可使用以下路径：

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

      • 说明：从最新的 LTS 版本直接升级。
      • 测试状态：所有 patch 版本都已测试；最新 patch 版本会进行全面回归测试。
      • 示例：4.10.x (LTS) → 4.12.x (non-LTS)

    • 扩展路径：向前追溯两个 LTS 版本 → 当前非 LTS

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

    • 维护路径：非 LTS（仍在维护中）→ 当前非 LTS

      • 说明：适用于仍受支持的非 LTS 版本的升级路径。
      • 测试状态：测试范围有限；理论上支持。
      • 使用场景：适用于快速采用非 LTS release 中新功能的团队。

    Patch 级兼容性

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

    升级流程参考

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