#升级路径

#概述

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.3.0

该升级路径已在 Alauda DevOps Pipelines Operator 版本 v4.3.0 及 ACP 版本 4.0.4、4.1.1（测试时可用的最新 LTS 补丁版本）下测试通过

Channel version	ACP version	Kubernetes version
pipelines-4.0	4.0.4	1.31.6
	4.1.1	1.32.7
pipelines-4.1	4.0.4	1.31.6
	4.1.1	1.32.7
pipelines-4.2	4.0.4	1.31.6
	4.1.1	1.32.7

#Alauda DevOps Pipelines v4.2.0

该升级路径已在 Alauda DevOps Pipelines Operator 版本 v4.2.0 及 ACP 版本 4.0.3、4.1.0（测试时可用的最新 LTS 补丁版本）下测试通过

Channel version	ACP version	Kubernetes version
pipelines-4.0	4.0.3	1.31.6
	4.1.0	1.32.7
pipelines-4.1	4.0.3	1.31.6
	4.1.0	1.32.7

#Alauda DevOps Pipelines v4.1.0

该升级路径已在 Alauda DevOps Pipelines Operator 版本 v4.1.0 及 ACP 版本 4.0.3（测试时可用的最新 LTS 补丁版本）下测试通过

Channel version	ACP version	Kubernetes version
pipelines-4.0	4.0.3	1.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 (非 LTS)

• 扩展路径：跳过两个 LTS 版本 → 当前非 LTS

  • 描述：直接跳过最多两个中间 LTS 版本的升级路径。
  • 测试状态：所有补丁版本均已测试；最新补丁版本进行全面回归测试。
  • 适用场景：适用于希望减少升级跳数的用户。
  • 示例：4.0.x (LTS) → 4.7.x (非 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：版本特定的更新、破坏性变更及新功能说明。