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 Chains,通过为 Tekton TaskRuns 生成和验证加密签名,保障其 CI/CD 流水线的安全。

#目录

#介绍

#使用场景

Tekton Chains 通过自动为构建产物生成加密签名,帮助您保障软件供应链的安全。本指南演示如何设置 Tekton Chains、生成签名密钥、运行简单任务并验证其签名。

#预计阅读时间

10-15 分钟

#重要说明

  • 使用 Alauda Devops Pipelines Operator 时,Tekton Chains 默认安装在 tekton-pipelines 命名空间中
  • 签名密钥应安全管理;在生产环境中,建议使用密钥管理系统(KMS)
  • 本指南使用最简单的配置进行演示

#前提条件

  • 已安装 Tekton Pipelines 和 Tekton Chains 的 Kubernetes 集群
  • 已安装并配置好访问集群的 kubectl CLI
  • 已安装 cosign CLI 工具
  • 已安装 jq CLI 工具

#流程概览

步骤操作说明
1生成签名密钥创建用于签名产物的密钥对
2配置 Tekton Chains设置 Chains 使用 Tekton 存储后端
3运行示例任务创建并运行一个简单的 TaskRun
4验证签名提取并验证 TaskRun 的签名

#逐步操作指南

#步骤 1:生成签名密钥

更多详情请参考 Signing Key Configuration

Tekton Chains 使用加密密钥对产物进行签名。默认情况下,它会在 Chains 命名空间中查找名为 signing-secrets 的 Secret。

  1. 如果尚未安装,请安装 cosign

  2. 生成密钥对并以 Kubernetes Secret 形式存储:

    $ COSIGN_PASSWORD={password} cosign generate-key-pair k8s://tekton-pipelines/signing-secrets
    
    Successfully created secret signing-secrets in namespace tekton-pipelines
    Public key written to cosign.pub
    TIP

    该密码将存储在 tekton-pipelines 命名空间中的 Kubernetes Secret signing-secrets 中。

  3. 验证 Secret 是否创建成功:

    $ kubectl get secret signing-secrets -n tekton-pipelines
    
    NAME              TYPE     DATA   AGE
    signing-secrets   Opaque   3      3m

#步骤 2:配置 Tekton Chains

通过应用以下配置,将 Tekton Chains 设置为以 Tekton 格式存储产物:

$ kubectl patch tektonconfigs.operator.tekton.dev config --type=merge -p='{
  "spec": {
    "chain": {
      "artifacts.oci.storage": "",
      "artifacts.taskrun.format": "in-toto",
      "artifacts.taskrun.storage": "tekton"
    }
  }
}'

YAML 字段说明:

  • artifacts.oci.storage:OCI 产物的存储类型。设置为空字符串表示跳过存储。
  • artifacts.taskrun.format:TaskRun 产物的格式。设置为 in-toto 表示使用 in-toto 格式。
  • artifacts.taskrun.storage:TaskRun 产物的存储类型。设置为 tekton 表示存储在 Tekton TaskRun 注解中。

#步骤 3:运行示例任务

现在创建一个简单的 TaskRun,Chains 会自动为其签名。

  1. 创建一个简单的 TaskRun:

    $ export NAMESPACE=default
    
    $ cat <<'EOF' | kubectl create -n $NAMESPACE -f -
    apiVersion: tekton.dev/v1
    kind: TaskRun
    metadata:
      name: build-push-run-output-image-test
    spec:
      serviceAccountName: ""
      taskSpec:
        results:
        - name: IMAGE_URL
          type: string
        - name: IMAGE_DIGEST
          type: string
        steps:
        - name: create-image
          image: <registry>/ops/busybox:latest
          script: |-
            #!/bin/sh
            echo 'gcr.io/foo/bar' | tee $(results.IMAGE_URL.path)
            echo 'sha256:05f95b26ed10668b7183c1e2da98610e91372fa9f510046d4ce5812addad86b5' | tee $(results.IMAGE_DIGEST.path)
    EOF
    TIP

    请将镜像 <registry>/ops/busybox:latest 替换为您实际想使用的镜像。

  2. 等待 TaskRun 完成:

    $ kubectl get taskruns.tekton.dev -n $NAMESPACE -w
    
    NAME                               SUCCEEDED   REASON      STARTTIME   COMPLETIONTIME
    build-push-run-output-image-test   True        Succeeded   42s         33s

    等待状态显示为 Succeeded。

#步骤 4:验证签名

TaskRun 完成后,Tekton Chains 会自动为其签名。现在验证该签名。

  1. 获取 TaskRun 的 UID:

    export TASKRUN_UID=$(kubectl get taskruns.tekton.dev -n $NAMESPACE build-push-run-output-image-test -o jsonpath='{.metadata.uid}')
  2. 提取签名:

    kubectl get taskruns.tekton.dev -n $NAMESPACE -o jsonpath="{.items[0].metadata.annotations.chains\.tekton\.dev/signature-taskrun-$TASKRUN_UID}" | base64 -d > sig
  3. 使用 jq 提取负载:

    cat sig | jq '.payload | @base64d' | jq -r '.' | jq '.'
签名负载
{
  "_type": "https://in-toto.io/Statement/v0.1",
  "subject": [
    {
      "name": "gcr.io/foo/bar",
      "digest": {
        "sha256": "05f95b26ed10668b7183c1e2da98610e91372fa9f510046d4ce5812addad86b5"
      }
    }
  ],
  "predicateType": "https://slsa.dev/provenance/v0.2",
  "predicate": {
    "buildConfig": {
      "steps": [
        {
          "annotations": null,
          "arguments": null,
          "entryPoint": "#!/bin/sh\necho 'gcr.io/foo/bar' | tee /tekton/results/IMAGE_URL\necho 'sha256:05f95b26ed10668b7183c1e2da98610e91372fa9f510046d4ce5812addad86b5' | tee /tekton/results/IMAGE_DIGEST",
          "environment": {
            "container": "create-image",
            "image": "oci://<registry>/ops/busybox@sha256:ce57c394018ade463dede7cbc721c41d7bc6bc858c62d810681ff41d00d8e942"
          }
        }
      ]
    },
    "buildType": "tekton.dev/v1beta1/TaskRun",
    "builder": {
      "id": "https://tekton.dev/chains/v2"
    },
    "invocation": {
      "configSource": {},
      "environment": {
        "annotations": {
          "cpaas.io/creator": "kubernetes-admin",
          "cpaas.io/updated-at": "2025-06-15T15:18:32Z",
          "pipeline.tekton.dev/release": "002f74eea37b0f5dbcfed39c13d7cd762c8fcdc4"
        },
        "labels": {
          "app.kubernetes.io/managed-by": "tekton-pipelines"
        }
      },
      "parameters": {}
    },
    "materials": [
      {
        "digest": {
          "sha256": "ce57c394018ade463dede7cbc721c41d7bc6bc858c62d810681ff41d00d8e942"
        },
        "uri": "oci://<registry>/ops/busybox"
      }
    ],
    "metadata": {
      "buildFinishedOn": "2025-06-15T15:18:41Z",
      "buildStartedOn": "2025-06-15T15:18:32Z",
      "completeness": {
        "environment": false,
        "materials": false,
        "parameters": false
      },
      "reproducible": false
    }
  }
}
  1. 使用 cosign 验证签名:

    $ cosign verify-blob-attestation --insecure-ignore-tlog --key k8s://tekton-pipelines/signing-secrets --signature sig --type slsaprovenance --check-claims=false /dev/null
    
    WARNING: Skipping tlog verification is an insecure practice that lacks transparency and auditability verification for the blob attestation.
    Verified OK

    如果成功,您将看到 Verified OK。

#预期结果

完成本指南后:

  • 您已成功搭建 Tekton Chains 并拥有签名密钥
  • TaskRuns 完成时会自动被签名
  • 您可以验证签名以确保构建的完整性

这展示了 Tekton Chains 的基本功能。在实际场景中,您还可以:

  1. 配置 Chains 为容器镜像签名并将签名存储在镜像仓库
  2. 在部署流程中设置验证步骤
  3. 可能使用云 KMS 以实现更安全的密钥管理

#参考资料

  • Chains Getting Started Tutorial
  • Chains Configuration