升级 Alauda DevOps Pipelines Operator
本文档提供了在集群中使用 Marketplace/OperatorHub 界面对 Alauda DevOps Pipelines Operator 升级到新版本的说明。该升级过程旨在尽可能简单,同时确保对现有 Tekton 资源的影响最小。
升级概述
升级 Alauda DevOps Pipelines Operator 后,您可以访问 Tekton 生态系统中的新功能、缺陷修复和改进。Alauda DevOps Pipelines Operator 会根据您的配置,处理所有 Tekton 组件(Pipelines、Triggers、Hub 等)的升级。
开始之前
在升级 Alauda DevOps Pipelines Operator 之前,请确保您:
- 具有集群的管理权限
- 查看新版本的 release notes,以了解任何不兼容变更
- 验证现有 Tekton 组件配置与新版本兼容
- 确认所有 Tekton 组件均处于就绪状态
首先确认目标通道
在批准升级之前,请确认您的 Subscription 使用的是哪个通道:
stable(从v4.2.5开始的默认通道):跟踪v4.2.zLTS 补丁发布。推荐用于生产环境。latest:跟踪每个v4.2.z发布版本。它与 4.2 LTS 线上的stable等价,并且在v4.2.5之前是默认通道。pipelines-4.2:仅跟踪v4.2.z补丁更新——内容与stable相同。
这三个通道在 release-4.2 线上都提供相同的 v4.2.z 补丁流。通道的选择主要影响您的 Subscription 中显示的通道名称;在这三个通道之间,升级行为是相同的。
升级过程
使用 Marketplace/OperatorHub
-
访问
Marketplace/OperatorHub- 登录到集群的管理控制台
- 导航到
Marketplace或OperatorHub部分
-
定位
Alauda DevOps PipelinesOperator- 在搜索栏中搜索
Alauda DevOps Pipelines - 单击
Alauda DevOps Pipelines卡片
- 在搜索栏中搜索
-
查看可用版本
- 在
Alauda DevOps PipelinesOperator 详情页面上,您将看到当前已安装版本的信息 - 如果有更新版本可用,界面会进行提示
- 您可以单击不同的
Channels查看所有可用版本
- 在
-
启动升级
- 如果目标版本位于不同的
Channel中,请先在Subscription中切换到对应的Channel - 如果当前
Channel有更新版本可用,您将看到提示:- New Version Detected
- 若只升级当前 Operator,请单击
Confirm进行升级。
- 若只升级当前 Operator,请单击
- New Version Detected
- 如果目标版本位于不同的
-
配置升级设置(如适用)
- 某些升级可能会提供配置选项
- 在大多数情况下,默认设置将保留您现有的配置
-
确认并开始升级
- 单击
Confirm开始该过程 - 查看升级详情并确认您的选择
- 系统将在保持自定义资源不变的同时更新
Alauda DevOps PipelinesOperator
- 单击
-
监控升级
- 升级进度会显示在
OperatorHub界面中 - 您还可以在
tekton-operator命名空间中检查状态: 当所有 pod 都处于Running状态时,operator 升级完成。 然后 operator 将自动升级Pipelines、Triggers、Hub、Chains等组件。 - 检查组件升级状态:
当所有组件和 pod 都处于
Ready状态时,组件升级完成。
- 升级进度会显示在
-
验证升级
- 检查
Alauda DevOps PipelinesOperator 版本是否已更新: 当VERSION与新版本一致时,升级完成。 - 验证您的 Tekton 组件是否正常运行
- 测试您的 pipelines 是否可以成功运行
- 检查
使用 kubectl CLI
您也可以使用命令行界面升级 Alauda DevOps Pipelines Operator。此方法适用于自动化场景,或者当您更倾向于使用 CLI 进行操作时。
-
检查当前 Subscription
- 首先,识别当前的 subscription 及其通道:
-
切换到目标通道
- 如果您需要升级到不同通道中的版本,请 patch 该 subscription:
将
<target-channel>替换为所需的通道(例如pipelines-4.1、latest)。
- 如果您需要升级到不同通道中的版本,请 patch 该 subscription:
将
-
等待 UpgradePending 状态
- 监控 subscription 状态,直到其显示为
UpgradePending: 在输出中查找state: UpgradePending。
- 监控 subscription 状态,直到其显示为
-
批准 InstallPlan
-
当 subscription 处于
UpgradePending状态时,找到对应的 InstallPlan: -
通过将
approved字段设置为true来批准 InstallPlan:将
<installplan-name>替换为上一步中的实际 InstallPlan 名称。
-
-
监控升级进度
-
观察 subscription 状态,直到其变为 ready:
-
检查 operator pod 状态:
等待所有 pod 都处于
Running状态。
-
-
验证升级
- 确认 operator 版本已更新:
-
监控组件升级
- operator 将自动升级 Tekton 组件。监控它们的进度:
确保所有组件和 pod 都达到
Ready状态。
- operator 将自动升级 Tekton 组件。监控它们的进度:
确保所有组件和 pod 都达到
CLI 升级过程遵循与 GUI 方法相同的底层机制。主要区别在于,您需要手动控制通道切换和 InstallPlan 批准步骤。
升级后步骤
升级成功完成后:
-
验证组件状态
- 检查所有 Tekton 组件是否已更新:
-
测试功能
- 运行一个简单的 pipeline,以验证系统是否正常工作
- 确保所有现有集成都继续正常运行
-
如有需要,更新自定义资源
- 如果新版本引入了对 CRD 的更改,您可能需要更新自定义资源
- 有关具体迁移步骤,请参阅 release notes
回滚操作
如果您在新版本中遇到问题,可以回滚到之前的版本:
- 返回到
Marketplace/OperatorHub界面 - 选择
Alauda DevOps PipelinesOperator Uninstall当前版本- 从版本列表中选择之前的版本
- 按照该版本的安装过程进行操作
降级可能需要额外步骤,以确保您的资源与较旧版本兼容。
这取决于您升级前后的版本差异。如果差异较大,您可能需要手动迁移资源。
故障排查
如果您在升级过程中或升级后遇到问题:
-
检查
Alauda DevOps PipelinesOperator pod 日志: -
验证 Tekton 资源的状态:
-
确保所有组件都具有预期状态:
下一步
成功升级 Alauda DevOps Pipelines Operator 后:
- 了解最新版本中引入的新功能
- 更新您的 CI/CD pipelines,以利用新能力
- 考虑启用在新版本中可用的其他组件