#升级路径

#概述

Alauda Container Platform 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.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)）
• 仅支持将非 LTS 版本升级到下一个紧邻的 LTS 版本。例如：
  • 支持 4.3.x → 4.6.x (LTS)
  • 不支持 4.3.x → 4.10.x (LTS)
• 版本兼容性：同一次要版本中的补丁版本完全兼容
• 组件一致性：所有 Tekton 组件都将一同升级，以保持兼容性

#升级路径

#Alauda Container Platform Pipelines v4.6

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

#Alauda Container Platform Pipelines v4.4.0

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

#Alauda Container Platform Pipelines v4.3.0

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

#Alauda Container Platform Pipelines v4.2.0

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

#Alauda Container Platform Pipelines v4.1.0

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

#前置条件

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

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）经过了全面测试和验证。

#升级流程参考

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

• 📘 通用升级指南：有关升级流程的全面文档。
• 📝 release notes：特定版本的更新、重大变更和新功能。