#升级 Alauda DevOps Connectors Operator

本文档提供了使用集群中的 Marketplace/OperatorHub 界面升级 Alauda DevOps Connectors Operator 到新版本的操作步骤。升级过程设计简便，同时确保对现有资源的影响最小。

#升级概述

升级 Alauda DevOps Connectors Operator 可让您访问新功能、修复的漏洞以及组件的改进。Alauda DevOps Connectors Operator 会根据您的配置处理所有组件的升级。

#升级前准备

在升级 Alauda DevOps Connectors Operator 之前，请确保您：

• 拥有集群的管理员权限
• 查看新版本的 release notes，了解任何破坏性变更
• 验证现有 Connector 组件配置与新版本兼容
• 确认所有当前组件处于就绪状态

#升级流程

#使用 Marketplace/OperatorHub

1. 访问 Marketplace/OperatorHub

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

2. 定位 Alauda DevOps Connectors Operator

   • 在搜索栏中搜索 Alauda DevOps Connectors
   • 点击 Alauda DevOps Connectors 卡片

3. 查看可用版本

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

4. 发起升级

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

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

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

6. 确认并开始升级

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

7. 监控升级进度

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

     $ kubectl get pods -n connectors-operator
     当所有 Pod 处于 Running 状态时，Operator 升级完成。 Operator 会自动升级如 ConnectorCore、ConnectorsGit、ConnetorsOCI 等组件。
   • 检查组件升级状态：

     $ kubectl get installmanifest -n connectors-operator
     $ kubectl get pods -n connectors-operator
     当所有组件和 Pod 处于 Ready 状态时，组件升级完成。

8. 验证升级

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

     $ kubectl get csv -n connectors-operator
     
     NAME                         DISPLAY                    VERSION   REPLACES                     PHASE
     connectors-operator.v1.y.z   Alauda DevOps Connectors   1.y.z     connectors-operator.v1.y.z   Succeeded
     当 VERSION 与新版本匹配时，升级完成。
   • 验证所有 Connector 组件功能正常

#升级后步骤

升级成功完成后：

1. 验证组件状态

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

     kubectl get connectorscore,connectorsgit,connectorsoci -A

2. 测试功能

   • 使用 connector csi 运行作业或通过 oci connector 部署拉取镜像的应用，验证系统正常工作
   • 确保所有现有集成继续正常运行

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

   • 如果新版本引入了 CRD 变更，您可能需要更新自定义资源
   • 具体迁移步骤请参考 release notes

#回滚操作步骤

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

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

#故障排查

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

• 查看 Alauda DevOps Connectors Operator Pod 日志：

  $ kubectl logs -l control-plane=connectors-operator -n connectors-operator

• 验证 Connector 资源状态，例如 ConnectorCore：

  $ kubectl get connectorscore -A
  # 查找有问题的实例
  $ kubectl get connectorscore -n <namespace> <instance name> -o yaml

#后续步骤

成功升级 Alauda DevOps Connectors Operator 后：

• 探索新版本引入的新功能
• 考虑启用新版本中可能提供的额外组件