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 上编辑此页
上一页架构
下一页生命周期策略

#快速开始

本文档帮助新用户快速了解并安装 Tekton Operator,从而实现对 Kubernetes 集群中 Tekton 组件的管理。

#目录

#介绍

#适用场景

本指南适用于需要在 Kubernetes 集群上部署和管理 Tekton Pipeline、Triggers 或其他 Tekton 组件的用户。Tekton Operator 简化了这些组件的安装、升级和管理过程。

#预计阅读时间

10-15 分钟

#注意事项

  • 您必须具有集群管理员权限才能安装 Tekton Operator
  • 通过 Operator 安装 Tekton 组件会在您的集群中创建资源
  • 所有命令均假设您已配置 kubectl 以连接到您的集群

#前提条件

  • Kubernetes 集群(版本 1.21 或更高)
  • 已安装并配置 kubectl 命令行工具
  • 集群管理员权限
  • 可访问互联网以拉取容器镜像

#流程概览

序号操作步骤说明
1安装 Tekton Operator在您的 Kubernetes 集群中部署 Tekton Operator
2验证 Operator 安装确认 Tekton Operator 正常运行
3安装 Tekton 组件使用 Operator 安装 Tekton Pipeline、Triggers
4验证组件安装检查 Tekton 组件是否正确安装并运行

#操作步骤

#安装 Tekton Operator

Tekton Operator 允许您在 Kubernetes 集群中安装、升级和管理 Tekton Pipeline 和 Triggers 组件。

  1. 打开平台管理中的 Marketplace 的 Operator Hub

  2. 搜索 “Alauda DevOps Pipelines” 并点击 “Install”

  3. 选择安装 Operator 的命名空间,例如 tekton-operator

  4. 安装完成后,您可以在 tekton-operator 命名空间中看到该 Operator

#验证 Operator 安装

安装 Tekton Operator 后,应验证其是否正常运行,然后再继续操作。

  1. 检查 Operator pods 是否运行:

    $ kubectl get pods -n tekton-operator

    结果应类似如下:

    NAME                                       READY   STATUS    RESTARTS   AGE
    tekton-operator-57cfd5bb79-dnxzt           2/2     Running   0          10m
    tekton-operator-webhook-6fb66bfd65-ppfz8   1/1     Running   0          10m
  2. 验证 Operator CRDs(自定义资源定义)是否已安装:

    $ kubectl get crds | grep operator.tekton.dev

    结果应类似如下:

    tektonaddons.operator.tekton.dev                2025-06-20T09:47:38Z
    tektonchains.operator.tekton.dev                2025-06-20T09:47:38Z
    tektonconfigs.operator.tekton.dev               2025-06-20T09:47:38Z
    tektondashboards.operator.tekton.dev            2025-06-20T09:47:38Z
    tektonhubs.operator.tekton.dev                  2025-06-20T09:47:38Z
    tektoninstallersets.operator.tekton.dev         2025-06-20T09:47:38Z
    tektonpipelines.operator.tekton.dev             2025-06-20T09:47:39Z
    tektonresults.operator.tekton.dev               2025-06-20T09:47:39Z
    tektontriggers.operator.tekton.dev              2025-06-20T09:47:39Z
    manualapprovalgates.operator.tekton.dev         2025-06-20T09:47:38Z
    openshiftpipelinesascodes.operator.tekton.dev   2025-06-20T09:47:38Z

#安装 Tekton 组件

Tekton Operator 使用自定义资源来管理 Tekton 组件。 默认情况下,Operator 会自动安装 Pipeline、Triggers、Chains 和 Hub。 您可以通过创建这些自定义资源来安装 Results、Pipelines-as-Code。

#验证组件安装

安装 Tekton 组件后,应验证它们是否正常运行。

  1. 检查 TektonConfig 资源:

    $ kubectl get tektonconfig config

    结果应类似如下:

    NAME     VERSION           READY   REASON
    config   v0.74.1-fb53414   True
  2. 如果 TektonConfig 资源未就绪,您可以继续检查 TektonInstallerSet 资源以获取详细信息。

    kubectl get tektoninstallerset

    结果应类似如下:

    NAME                                READY   REASON
    chain-config-5scx2                  True
    chain-secret-xrq7b                  True
    chain-t6wb6                         True
    pipeline-main-deployment-9d9cc      True
    pipeline-main-static-c7zlz          True
    result-j74p5                        True
    tekton-hub-api-jl9xj                True
    tekton-hub-db-5g89c                 True
    tekton-hub-db-migration-q7m8l       True
    tekton-hub-ui-jn6bw                 True
    tektoncd-pruner-fgzfh               True
    trigger-main-deployment-q8zkd       True
    trigger-main-static-8x5w6           True
    validating-mutating-webhook-ksz2k   True

#预期结果

完成所有步骤后,TektonConfig 和 TektonInstallerSet 资源应处于就绪状态,您应拥有:

  • 在 tekton-operator 命名空间中运行的 Tekton Operator
  • 在 tekton-pipelines 命名空间中安装的一个或多个 Tekton 组件(Pipeline、Triggers、Hub、Chains)
  • 用于管理 Tekton 资源的自定义资源定义(CRDs)

#后续步骤

成功安装 Tekton Operator 和组件后,您可以:

  1. 学习如何创建和运行 Tekton Pipeline Tasks 和 Pipelines
  2. 设置 Tekton Triggers 以实现事件驱动的流水线
  3. 使用 Operator 配置 Tekton 组件的高级设置