#升级路径

#概述

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

#版本类型

• LTS（Long-Term Support）版本: 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)
• 版本兼容性：同一 minor 版本内的 patch 版本完全兼容
• 组件一致性：所有 Tekton 组件会一起升级，以保持兼容性

#升级路径

#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 版本）

#Alauda DevOps Pipelines v4.3.0

此升级路径已使用 Alauda DevOps Pipelines Operator v4.3.0 和 ACP 版本 4.0.4、4.1.1 进行测试（测试期间可用的最新 LTS patch 版本）

#Alauda DevOps Pipelines v4.2.0

此升级路径已使用 Alauda DevOps Pipelines Operator v4.2.0 和 ACP 版本 4.0.3、4.1.0 进行测试（测试期间可用的最新 LTS patch 版本）

#Alauda DevOps Pipelines v4.1.0

此升级路径已使用 Alauda DevOps Pipelines Operator v4.1.0 和 ACP 版本 4.0.3 进行测试（测试期间可用的最新 LTS patch 版本）

#前提条件

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

1. 版本兼容性：当前版本位于受支持的升级路径中。
2. 组件健康状态：所有 Tekton 组件均处于 Ready 状态。
3. 资源可用性：集群具有足够的资源来支持升级过程。

#升级路径指南

#LTS 到 LTS 的升级路径

建议在生产环境中从 Long-Term Support（LTS）版本之间进行升级。我们支持如下所述的标准升级路径和扩展升级路径：

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

  • 说明：从紧邻的上一个 LTS 版本直接升级。
  • 测试状态：所有 patch 版本均已测试；最新 patch 版本会进行全面的回归测试。
  • 示例：4.0.x (LTS) → 4.2.x (LTS)

• 扩展路径：向前最多两个 LTS 版本 → 当前 LTS

  • 说明：可跳过最多两个中间 LTS 版本的直接升级路径。
  • 测试状态：所有 patch 版本均已测试；最新 patch 版本会通过扩展测试进行验证。
  • 示例：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 版本直接升级。
  • 测试状态：所有 patch 版本均已测试；最新 patch 版本会进行全面的回归测试。
  • 示例：4.0.x (LTS) → 4.1.x (non-LTS)

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

  • 说明：可跳过最多两个中间 LTS 版本的直接升级路径。
  • 测试状态：所有 patch 版本均已测试；最新 patch 版本会进行全面的回归测试。
  • 使用场景：适用于希望尽量减少升级次数的用户。
  • 示例：4.0.x (LTS) → 4.7.x (non-LTS)（跳过 4.2.x (LTS) 和 4.6.x (LTS)）

• 维护路径：非 LTS（仍在维护中）→ 当前非 LTS

  • 说明：适用于仍受支持的非 LTS 版本的升级路径。
  • 测试状态：测试范围有限；理论上受支持。
  • 使用场景：适用于快速采用非 LTS 版本中新特性的团队。

#Patch 级别兼容性

• 同一 minor 版本内：patch 升级（例如 4.0.1 → 4.0.3）完全兼容。
• 测试策略：同一 minor 版本内的所有 patch 版本均支持升级。最新 patch 版本会经过全面回归测试，而较早的 patch 版本仅进行有限测试。
• 建议：为了保证生产环境稳定性，建议在执行任何 major 或 minor 版本升级之前，先升级到最新的 patch release。
• 示例：虽然 4.0.1、4.0.2 和 4.0.3 都可能符合升级到 4.1.x 的条件，但只有最新版本（4.0.3）经过了完整测试和验证。

#升级过程参考

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

• 📘 通用升级指南：升级流程的完整文档。
• 📝 release notes：特定版本更新、破坏性变更和新特性。