升级路径
重要
本文档介绍 Alauda DevOps Pipelines Operator 的升级路径原则以及受支持的版本兼容性。
有关详细的升级说明,请参阅 升级 Alauda DevOps Pipelines Operator。
目录
概述版本类型升级原则升级路径Alauda 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 升级路径升级到 Non-LTS 版本Patch 级别兼容性升级流程参考概述
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))
- 直接 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
下表包含完整的升级路径。
Alauda DevOps Pipelines v4.10
下表包含完整的升级路径。
Alauda DevOps Pipelines v4.8
下表包含完整的升级路径。
Alauda DevOps Pipelines v4.7
下表包含完整的升级路径。
Alauda DevOps Pipelines v4.6
下表包含完整的升级路径。
Alauda DevOps Pipelines v4.4.0
此升级路径已使用 Alauda DevOps Pipelines Operator 版本 v4.4.0 和 ACP 版本 4.0.5、4.1.2(测试期间可用的最新 LTS patch version)进行测试
Alauda DevOps Pipelines v4.3.0
此升级路径已使用 Alauda DevOps Pipelines Operator 版本 v4.3.0 和 ACP 版本 4.0.4、4.1.1(测试期间可用的最新 LTS patch version)进行测试
Alauda DevOps Pipelines v4.2.0
此升级路径已使用 Alauda DevOps Pipelines Operator 版本 v4.2.0 和 ACP 版本 4.0.3、4.1.0(测试期间可用的最新 LTS patch version)进行测试
Alauda DevOps Pipelines v4.1.0
此升级路径已使用 Alauda DevOps Pipelines Operator 版本 v4.1.0 和 ACP 版本 4.0.3(测试期间可用的最新 LTS patch version)进行测试
前提条件
在开始升级之前,请确保满足以下条件:
- 版本兼容性:当前版本位于受支持的升级路径中。
- 组件健康状态:所有 Tekton 组件均处于
Ready状态。 - 资源可用性:集群具备足够的资源以支持升级过程。
升级路径指南
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经过了完整测试和验证。
升级流程参考
有关完整的升级说明,包括逐步操作、备份指导和故障排查:
- 📘 通用升级指南:升级流程的完整文档。
- 📝 release notes:版本相关更新、breaking changes 和新特性。