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 上编辑此页
上一页StepActions
下一页工作空间

#解析器

解析器是 Tekton 中的一个组件,可实现对任务和管道等资源的远程解析。解析器允许您从外部位置引用和获取资源,而不是直接在 Kubernetes 集群中定义它们。

#目录

#解析器的必要性

#传统资源管理的挑战

在 CI/CD 系统中,跨团队和项目管理和共享资源面临若干挑战:

  • 版本控制:难以跟踪和管理 CI/CD 资源的版本
  • 共享:跨团队和组织共享资源的能力有限
  • 维护:多个管道使用的资源更新和维护的挑战
  • 发现性:发现和使用其他人创建的资源的难度
  • 一致性:确保各环境中的资源定义一致

#Tekton 的解决方案

Tekton 解析器通过以下方式解决这些挑战:

  • 远程解析:在运行时从外部位置获取资源
  • 版本管理:允许引用特定版本的资源
  • 集中存储:使资源能够存储在中央仓库中
  • 动态获取:在需要时检索资源的最新版本
  • 灵活来源:支持多种资源来源(Git、Bundles、HTTP 等)

#优势

  • 可重用性:资源可以轻松分享和重用于团队和项目之间
  • 版本控制:资源可以在源代码管理中进行版本化和跟踪
  • 减少重复:消除重复资源定义的需要
  • 简化更新:可以在一个地方更新资源,所有使用者自动使用更新
  • 改善发现性:资源可以在中央仓库中组织和发现
  • 一致性:确保各环境中的资源定义一致

#场景

解析器在各种场景中都很有用,包括:

  • 共享任务库:维护常用任务的中央仓库
  • CI/CD 模板:为团队提供标准化的管道模板
  • 跨环境一致性:确保开发、测试和生产环境中的资源定义一致
  • 组织标准:强制执行组织的 CI/CD 流程标准
  • 第三方集成:利用社区开发的任务和管道
  • 替换集群任务:提供共享任务而无需集群范围的资源

#约束和限制

  • 解析器需要网络访问外部资源位置
  • 解析发生在 TaskRun/PipelineRun 创建时,而不是执行时
  • 某些解析器可能需要额外的身份验证配置
  • 网络问题可能会影响远程解析资源的可用性
  • 使用外部资源时必须考虑安全性

#原则

#解析过程

当解析资源引用时:

  1. Tekton 从资源引用中识别解析器类型
  2. 调用适当的解析器以获取资源
  3. 解析器从外部位置检索资源
  4. 验证资源并将其转换为适当的 Tekton 资源
  5. 使用已解析的资源于 TaskRun 或 PipelineRun 中

#资源引用

资源引用指定:

  1. 要使用的解析器类型(git、bundle、hub 等)
  2. 资源的位置
  3. 可选参数,如版本、分支或路径
  4. 如需,身份验证信息

#配置示例

#Git 解析器示例

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: git-resolver-example
spec:
  taskRef:
    resolver: git
    params:
      - name: url
        value: https://github.com/tektoncd/catalog.git
      - name: revision
        value: main
      - name: pathInRepo
        value: task/git-clone/0.9/git-clone.yaml

#Hub 解析器示例

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: remote-task-reference
spec:
  taskRef:
    resolver: hub
    params:
    - name: catalog # 可选
      value: tekton-catalog-tasks
    - name: type # 可选
      value: artifact
    - name: kind
      value: task
    - name: name
      value: git-clone
    - name: version
      value: "0.6"

#HTTP 解析器示例

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: http-resolver-example
spec:
  taskRef:
    resolver: http
    params:
      - name: url
        value: https://raw.githubusercontent.com/tektoncd/catalog/main/task/git-clone/0.9/git-clone.yaml

#内置解析器

#Git 解析器

Git 解析器从 Git 仓库获取资源。

#使用案例

  • 在与应用程序代码相同的仓库中存储任务和管道
  • 与应用程序代码一起对 CI/CD 资源进行版本控制
  • 通过 Git 仓库跨团队共享资源

#原则

Git 解析器:

  • 克隆指定的 Git 仓库
  • 检出指定的修订版(分支、标签或提交)
  • 从指定路径检索资源
  • 通过 Kubernetes 秘密支持身份验证

#Hub 解析器

Hub 解析器从 Tekton Hub 获取资源。

#使用案例

  • 发现和使用社区贡献的任务和管道
  • 访问策划的 CI/CD 资源目录
  • 在经过良好测试和维护的资源上实现标准化

#原则

Hub 解析器:

  • 连接到 Tekton Hub API
  • 按名称和版本检索指定资源
  • 支持不同目录和版本
  • 提供访问社区贡献的资源

#HTTP 解析器

HTTP 解析器从远程 HTTP 服务器获取资源。

#使用案例

  • 从远程服务器获取资源
  • 访问自定义或私有资源
  • 利用现有的网络服务进行资源解析

#原则

HTTP 解析器:

  • 从远程服务器获取指定资源
  • 提供访问自定义或私有资源

#参考文献

  • Tekton 远程解析文档
  • 如何编写解析器
  • Tekton Git 解析器
  • Tekton Hub 解析器
  • Tekton HTTP 解析器