logo
Alauda DevOps Pipelines Docs
English
简体中文
English
简体中文
logo
Alauda DevOps Pipelines Docs
导航

概览

介绍
架构
快速开始
生命周期策略
发版日志
特性概述

触发器

介绍
架构

核心概念

Tekton Triggers 核心概念
EventListener
触发器
Interceptor
TriggerBinding
TriggerTemplate
快速开始

实用指南

设置事件监听器
使用 GitLab 事件触发器
创建 TriggerTemplate

问题处理

Pipeline 未被自动触发
permissions

概念

TektonConfig
TektonPipeline
安装

升级

升级路径
升级 Alauda DevOps Pipelines Operator

配置

调整子组件的可选配置项
配置流水线组件的资源配额
Pod 模板配置指南
定期清理 TaskRun 和 PipelineRun 资源

How To

通过 TektonConfig 在 global 集群中部署 tekton-pipelines

管道

介绍
架构

概念

任务
TaskRuns
流水线
PipelineRuns
StepActions
解析器
工作空间
Pod 模板
快速开始

实用指南

调整 Dockerfile 构建适用于 Task 的自定义镜像
Specifying remote pipelines using hub resolvers
Specifying remote tasks using hub resolvers
使用 java-image-build-scan-deploy 管道

故障排查

在 Tekton 中使用自定义镜像时遇到容器创建失败的问题
在 run-script Task 中使用自定义镜像时遇到权限不够的问题
在 Tekton 中遇到无法使用多个基于 PVC 的工作区的问题
权限

结果

介绍
架构

核心概念

核心概念
深入理解 Tekton Results
快速开始
permissions

配置

数据库配置

供应链安全

介绍
架构

概念

核心概念
了解 Tekton Chains

快速开始

Getting Started
签名证明

实用指南

生成镜像签名并验证镜像完整性
构建系统溯源验证
源代码仓库验证
漏洞扫描和验证
Base Image and SBOM Verification
License Compliance Verification
Keyless Signing Verification

配置

链配置
链配置
Authentication for Chains
签名密钥配置

Hub

引言
架构

核心概念

概念
理解 Tekton Hub
权限描述

API Reference

介绍

Kubernetes APIs

Operator

TektonConfig [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
TektonPipeline [operator.tekton.dev/v1alpha1]
TektonTrigger [operator.tekton.dev/v1alpha1]
TektonChain [operator.tekton.dev/v1alpha1]
TektonHub [operator.tekton.dev/v1alpha1]
TektonResult [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
OpenShift Pipelines as Code [operator.tekton.dev/v1alpha1]

管道

Pipeline [tekton.dev/v1]
任务 [tekton.dev/v1]
PipelineRun [tekton.dev/v1]
TaskRun [tekton.dev/v1]
集群任务 [tekton.dev/v1]
运行 [tekton.dev/v1]
CustomRun [tekton.dev/v1]
StepAction [tekton.dev/v1]
VerificationPolicy [tekton.dev/v1alpha1]
ResolutionRequest [resolution.tekton.dev/v1beta1]

Triggers

触发器 [triggers.tekton.dev/v1beta1]
TriggerTemplate [triggers.tekton.dev/v1beta1]
EventListener [triggers.tekton.dev/v1beta1]
触发绑定 [triggers.tekton.dev/v1beta1]
拦截器 [triggers.tekton.dev/v1alpha1]
集群触发器绑定 [triggers.tekton.dev/v1beta1]
集群拦截器 [triggers.tekton.dev/v1alpha1]

高级 API

Results

Introduction to API Usage
Results 列表
结果详情
结果记录列表
Result logs 列表
📝 在 GitHub 上编辑此页
上一页升级路径
下一页配置

#升级 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

    • 首先确认当前订阅及其 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 的版本,修改订阅:
      $ 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 状态

    • 监控订阅状态,直到显示 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

    • 当订阅处于 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. 监控升级进度

    • 观察订阅状态直到变为 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 方法底层机制相同,主要区别在于您需要手动控制 channel 切换和 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. 卸载当前版本
  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 以利用新能力
  • 考虑启用新版本中可能提供的额外组件