升级路径

NOTE

重要提示

本文档提供了 Alauda DevOps Pipelines operator 的升级路径原则及支持的版本兼容性。 有关详细的升级操作说明,请参阅 升级 Alauda DevOps Pipelines Operator。

目录

概述

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

该升级路径已在 Alauda DevOps Pipelines Operator 版本 v4.4.0 及 ACP 版本 4.0.5、4.1.2(测试时最新的 LTS 补丁版本)下测试通过

Channel versionACP versionKubernetes version
pipelines-4.04.0.51.31.12
4.1.21.32.7
pipelines-4.14.0.51.31.12
4.1.21.32.7
pipelines-4.24.0.51.31.12
4.1.21.32.7
pipelines-4.34.0.51.31.12
4.1.21.32.7

Alauda DevOps Pipelines v4.3.0

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

Channel versionACP versionKubernetes version
pipelines-4.04.0.41.31.6
4.1.11.32.7
pipelines-4.14.0.41.31.6
4.1.11.32.7
pipelines-4.24.0.41.31.6
4.1.11.32.7

Alauda DevOps Pipelines v4.2.0

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

Channel versionACP versionKubernetes version
pipelines-4.04.0.31.31.6
4.1.01.32.7
pipelines-4.14.0.31.31.6
4.1.01.32.7

Alauda DevOps Pipelines v4.1.0

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

Channel versionACP versionKubernetes version
pipelines-4.04.0.31.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 (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 经过完整测试和验证。

升级流程参考

有关完整的升级说明,包括分步操作、备份指导及故障排查: