升级 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.z LTS 补丁发布。推荐用于生产环境。
  • latest:跟踪每个 v4.2.z 发布版本。它与 4.2 LTS 线上的 stable 等价,并且在 v4.2.5 之前是默认通道。
  • pipelines-4.2:仅跟踪 v4.2.z 补丁更新——内容与 stable 相同。
NOTE

这三个通道在 release-4.2 线上都提供相同的 v4.2.z 补丁流。通道的选择主要影响您的 Subscription 中显示的通道名称;在这三个通道之间,升级行为是相同的。

升级过程

使用 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 有更新版本可用,您将看到提示:
      • New Version Detected
        • 若只升级当前 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 及其通道:
      $ kubectl get subscriptions.operators.coreos.com -A | grep tektoncd-operator
      
      NAMESPACE               NAME                    PACKAGE                 SOURCE     CHANNEL
      tekton-operator         tektoncd-operator       tektoncd-operator       platform   latest
  2. 切换到目标通道

    • 如果您需要升级到不同通道中的版本,请 patch 该 subscription:
      $ kubectl patch subscriptions.operators.coreos.com tektoncd-operator --type merge -p '{"spec":{"channel": "<target-channel>"}}' -n tekton-operator
      将 <target-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 状态,直到其变为 ready:

      $ 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 状态。
NOTE

CLI 升级过程遵循与 GUI 方法相同的底层机制。主要区别在于,您需要手动控制通道切换和 InstallPlan 批准步骤。

升级后步骤

升级成功完成后:

  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. Uninstall 当前版本
  4. 从版本列表中选择之前的版本
  5. 按照该版本的安装过程进行操作
NOTE

降级可能需要额外步骤,以确保您的资源与较旧版本兼容。

这取决于您升级前后的版本差异。如果差异较大,您可能需要手动迁移资源。

故障排查

如果您在升级过程中或升级后遇到问题:

  • 检查 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,以利用新能力
  • 考虑启用在新版本中可用的其他组件