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 上编辑此页
上一页Pod 模板
下一页实用指南

#快速开始

本文档帮助新用户快速了解并使用 Tekton Pipelines 创建一个简单的 CI/CD 工作流。

#目录

#介绍

Tekton 是一个开源的云原生 CI/CD(持续集成和持续交付/部署)解决方案。它提供 Kubernetes 原生的构建模块,用于创建容器化、标准化和可移植的 CI/CD 流水线。

#使用场景

  • 创建自动化的构建、测试和部署工作流
  • 以 Kubernetes 原生方式运行 CI/CD 流水线
  • 在无特权访问的情况下构建容器镜像
  • 实现跨多个云提供商的标准化部署流程
  • 为您的 CI/CD 系统创建可复用组件

#预计阅读时间

15-20 分钟

#前提条件

  • 一个 Kubernetes 集群(您可以使用 minikube 进行本地测试)
  • 在集群上安装了 Tekton Pipelines
  • 已安装并配置好用于访问集群的 kubectl
  • 安装了 Tekton CLI (tkn),以便更方便地与 Tekton 资源交互
    • Install tkn

#流程概览

步骤操作描述
1创建一个 "Hello World" Task创建一个输出问候消息的基础 Task
2创建一个 "Goodbye" Task创建第二个接受参数的 Task
3创建一个 Pipeline创建一个将两个 Task 按顺序组合的 Pipeline
4运行 Pipeline执行 Pipeline 并查看结果
5清理删除创建的资源

#逐步操作指南

#第 1 步:创建一个 "Hello World" Task

Task 是 Tekton Pipeline 的基本构建块。它由一系列在容器中顺序执行的步骤组成。

  1. 创建一个名为 hello-task.yaml 的文件,内容如下:

    apiVersion: tekton.dev/v1
    kind: Task
    metadata:
      name: hello
    spec:
      steps:
        - name: echo
          image: ubuntu
          command:
            - echo
          args:
            - "Hello World!"
    TIP

    请将 ubuntu 镜像替换为实际可访问的镜像,以下同理。

  2. 将 Task 应用到您的集群:

    kubectl apply -f hello-task.yaml
  3. TaskRun 对象用于实例化并执行该 Task。创建另一个名为 hello-world-run.yaml 的文件,内容如下:

    apiVersion: tekton.dev/v1
    kind: TaskRun
    metadata:
      name: hello-task-run
    spec:
      taskRef:
        name: hello
  4. 将 TaskRun 应用到您的集群:

    kubectl apply -f hello-world-run.yaml
  5. 监控 TaskRun 执行情况:

    kubectl get taskrun hello-task-run

    您应该看到类似如下输出:

    NAME            SUCCEEDED   REASON      STARTTIME   COMPLETIONTIME
    hello-task-run  True        Succeeded   1m         2m
  6. 查看日志:

    kubectl logs --selector=tekton.dev/taskRun=hello-task-run

    您应该看到类似如下输出:

    Hello World!

#第 2 步:创建一个带参数的 "Goodbye" Task

现在创建第二个 Task,支持参数以提高灵活性。

  1. 创建一个名为 goodbye-task.yaml 的文件,内容如下:

    apiVersion: tekton.dev/v1
    kind: Task
    metadata:
      name: goodbye
    spec:
      params:
        - name: username
          type: string
          description: The username to say goodbye to
          default: "World"
      steps:
        - name: goodbye
          image: ubuntu
          command:
            - echo
          args:
            - "Goodbye $(params.username)!"
  2. 将 Task 应用到您的集群:

    kubectl apply -f goodbye-task.yaml

#第 3 步:创建 Pipeline

Pipeline 定义了一系列按特定执行顺序排列的 Task,作为您的 CI/CD 工作流的一部分。

  1. 创建一个名为 hello-goodbye-pipeline.yaml 的文件,内容如下:

    apiVersion: tekton.dev/v1
    kind: Pipeline
    metadata:
      name: hello-goodbye
    spec:
      params:
        - name: username
          type: string
          description: The username to say goodbye to
          default: "World"
      tasks:
        - name: hello
          taskRef:
            name: hello
        - name: goodbye
          runAfter:
            - hello
          taskRef:
            name: goodbye
          params:
            - name: username
              value: "$(params.username)"

    该 Pipeline:

    • 定义了一个名为 username 的参数
    • 包含两个 Task:hello 和 goodbye
    • 指定 goodbye 在 hello 完成后运行
    • 将 Pipeline 参数传递给 goodbye Task
  2. 将 Pipeline 应用到您的集群:

    kubectl apply -f hello-goodbye-pipeline.yaml

#第 4 步:运行 Pipeline

PipelineRun 用于执行 Pipeline 并提供所需参数。

  1. 创建一个名为 hello-goodbye-pipeline-run.yaml 的文件,内容如下:

    apiVersion: tekton.dev/v1
    kind: PipelineRun
    metadata:
      name: hello-goodbye-run
    spec:
      pipelineRef:
        name: hello-goodbye
      params:
        - name: username
          value: "Tekton"
  2. 将 PipelineRun 应用到您的集群以启动 Pipeline:

    kubectl apply -f hello-goodbye-pipeline-run.yaml
  3. 监控 Pipeline 执行:

    tkn pipelinerun logs hello-goodbye-run -f

    您应该看到类似如下输出:

    [hello : echo] Hello World!
    [goodbye : goodbye] Goodbye Tekton!

#第 5 步:清理

删除本教程中创建的资源:

kubectl delete -f hello-task.yaml
kubectl delete -f hello-task-run.yaml
kubectl delete -f goodbye-task.yaml
kubectl delete -f hello-goodbye-pipeline.yaml
kubectl delete -f hello-goodbye-pipeline-run.yaml