Alauda DevOps Pipelines Docs
  • 简体中文

    • 升级路径

    NOTE

    重要提示

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

    目录

    概述

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

    版本类型

    • LTS（长期支持）版本：4.0.x、4.2.x、4.6.x、4.10.x - 推荐用于生产环境
    • 非LTS（短期）版本：4.1.x、4.3.x、4.5.x、4.7.x、4.9.x - 用于提前体验新功能

    升级原则

    • 支持在 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) 不支持
    • 版本兼容性：同一小版本内的补丁版本完全兼容
    • 组件协同：所有 Tekton 组件需一同升级以保持兼容性

    升级路径

    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 补丁版本）下测试通过。

    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 补丁版本）下测试通过。

    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 补丁版本）下测试通过。

    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 补丁版本）下测试通过。

    Channel versionACP versionKubernetes version
    pipelines-4.04.0.31.31.6

    升级前提条件

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

    1. 版本兼容性：当前版本处于支持的升级路径范围内。
    2. 组件健康状态：所有 Tekton 组件均处于 Ready 状态。
    3. 资源充足：集群拥有足够资源支持升级过程。

    升级路径指南

    LTS 到 LTS 的升级路径

    建议生产环境在长期支持（LTS）版本之间进行升级。我们支持以下标准及扩展升级路径：

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

      • 描述：从紧邻的前一个 LTS 版本直接升级。
      • 测试状态：所有补丁版本均已测试；最新补丁版本经过全面回归测试。
      • 示例：4.0.x (LTS) → 4.2.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.0.x (LTS) → 4.1.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 经过完整测试和验证。

    升级流程参考

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