#升级 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 是否能成功执行

#升级后步骤

升级成功完成后：

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 以利用新能力
• 考虑启用新版本中可能提供的额外组件