#升级 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 组件处于就绪状态

#升级流程

#使用 Marketplace/OperatorHub

1. 访问 Marketplace/OperatorHub

   • 登录集群管理控制台
   • 进入 Marketplace 或 OperatorHub 页面

2. 查找 Alauda DevOps Pipelines Operator

   • 在搜索栏输入 Alauda DevOps Pipelines
   • 点击 Alauda DevOps Pipelines 卡片

3. 查看可用版本

   • 在 Alauda DevOps Pipelines Operator 详情页，查看当前安装的版本信息
   • 界面会提示是否有新版本可用
   • 可点击不同的 Channels 查看所有可用版本

4. 发起升级

   • 如果目标版本属于不同的 Channel，请先在 Subscription 中切换到对应的 Channel
   • 如果当前 Channel 有新版本，系统会弹出提示：
     • 检测到新版本
       • 若只升级当前 Operator，点击 Confirm 进行升级。

5. 配置升级设置（如适用）

   • 部分升级可能会提供配置选项
   • 大多数情况下，默认设置会保留您现有的配置

6. 确认并开始升级

   • 点击 Confirm 开始升级流程
   • 审核升级详情并确认选择
   • 系统将更新 Alauda DevOps Pipelines Operator，同时保留您的自定义资源

7. 监控升级进度

   • 升级进度将在 OperatorHub 界面显示
   • 也可以在 tekton-operator 命名空间查看状态：

     $ kubectl get pods -n tekton-operator
     当所有 Pod 处于 Running 状态时，Operator 升级完成。 Operator 会自动升级 Pipelines、Triggers、Hub、Chains 等组件。
   • 检查组件升级状态：

     $ kubectl get tektoninstallerset -A
     $ kubectl get pods -n tekton-pipelines
     当所有组件和 Pod 处于 Ready 状态时，组件升级完成。

8. 验证升级

   • 检查 Alauda DevOps Pipelines Operator 版本是否已更新：

     $ kubectl get csv -n tekton-operator
     
     NAME                        DISPLAY                   VERSION   REPLACES   PHASE
     tektoncd-operator.v4.x.x    Alauda DevOps Pipelines   4.x.x     x          Succeeded
     当 VERSION 与新版本一致时，升级完成。
   • 验证 Tekton 组件功能是否正常
     • 测试您的 pipelines 是否能成功运行

#使用 kubectl CLI

您也可以通过命令行界面升级 Alauda DevOps Pipelines Operator。此方法适合自动化或偏好 CLI 操作的场景。

1. 检查当前 Subscription

   • 首先确认当前的 Subscription 及其 channel：

     $ kubectl get subscriptions.operators.coreos.com -A | grep tektoncd-operator
     
     NAMESPACE               NAME                    PACKAGE                 SOURCE     CHANNEL
     tekton-operator         tektoncd-operator       tektoncd-operator       platform   latest

2. 切换到目标 Channel

   • 若需升级到不同 channel 的版本，使用 patch 命令切换：

     $ kubectl patch subscriptions.operators.coreos.com tektoncd-operator --type merge -p '{"spec":{"channel": "<target-channel>"}}' -n tekton-operator
     将 <target-channel> 替换为目标 channel（如 pipelines-4.1、latest）。

3. 等待 UpgradePending 状态

   • 监控 Subscription 状态，直到显示 UpgradePending：

     $ kubectl get subscriptions.operators.coreos.com tektoncd-operator -n tekton-operator -o yaml
     
     status:
       installplan:
         apiVersion: operators.coreos.com/v1alpha1
         kind: InstallPlan
         name: install-abc123
       state: UpgradePending
     查找输出中的 state: UpgradePending。

4. 批准 InstallPlan

   • 当 Subscription 处于 UpgradePending 状态时，找到对应的 InstallPlan：

     $ kubectl get installplan -n tekton-operator
     
     NAME            CSV                        APPROVAL   APPROVED
     install-abc123  tektoncd-operator.v4.x.x  Manual     false

   • 通过设置 approved 字段为 true 来批准 InstallPlan：

     $ kubectl patch installplans.operators.coreos.com <installplan-name> --type merge -p '{"spec":{"approved":true}}' -n tekton-operator

     将 <installplan-name> 替换为上一步中实际的 InstallPlan 名称。

5. 监控升级进度

   • 观察 Subscription 状态直到变为就绪：

     $ kubectl get subscriptions.operators.coreos.com tektoncd-operator -n tekton-operator -o yaml -w

   • 查看 Operator Pod 状态：

     $ kubectl get pods -n tekton-operator

     等待所有 Pod 处于 Running 状态。

6. 验证升级

   • 确认 Operator 版本已更新：

     $ kubectl get csv -n tekton-operator
     
     NAME                        DISPLAY                   VERSION   REPLACES   PHASE
     tektoncd-operator.v4.x.x    Alauda DevOps Pipelines   4.x.x     x          Succeeded

7. 监控组件升级

   • Operator 会自动升级 Tekton 组件，监控其进度：

     $ kubectl get tektoninstallerset -A
     $ kubectl get pods -n tekton-pipelines
     确保所有组件和 Pod 达到 Ready 状态。

#升级后步骤

升级成功完成后：

1. 验证组件状态

   • 检查所有 Tekton 组件是否已更新：

     kubectl get tektonconfig,tektonpipeline,tektontrigger -A
     kubectl get tektoninstallerset -A

2. 测试功能

   • 运行简单的 pipeline，验证系统正常工作
   • 确保所有现有集成继续正常运行

3. 如有需要，更新自定义资源

   • 若新版本对 CRD 有变更，可能需要更新自定义资源
   • 请参考 release notes 中的具体迁移步骤

#回滚操作

如果新版本出现问题，可以回滚到之前的版本：

1. 返回 Marketplace/OperatorHub 界面
2. 选择 Alauda DevOps Pipelines Operator
3. 卸载当前版本
4. 从版本列表中选择之前的版本
5. 按照该版本的安装流程进行安装

#故障排查

升级过程中或升级后遇到问题时：

• 查看 Alauda DevOps Pipelines Operator Pod 日志：

  $ kubectl logs -l name=tekton-operator -n tekton-operator

• 验证 Tekton 资源状态：

  $ kubectl get tektonconfig config -o yaml

• 确认所有组件状态符合预期：

  $ kubectl get tektoninstallerset

#后续步骤

成功升级 Alauda DevOps Pipelines Operator 后：

• 探索最新版本引入的新功能
• 更新您的 CI/CD pipelines 以利用新能力
• 考虑启用新版本中可能提供的额外组件