#升级路径

#概述

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

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

Channel 版本	ACP 版本	Kubernetes 版本
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：版本特定的更新、破坏性变更及新功能。