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 上编辑此页
上一页实用指南
下一页构建系统溯源验证

#Image Signature Verification

在 Tekton Chains 中,可以自动为构建的镜像生成签名,并将签名记录在 SLSA Provenance 中。

#目录

#功能概述

此方法使用 Tekton Chains 自动为构建的镜像生成签名,然后使用 cosign 或 Kyverno 验证签名:

  1. 配置 Tekton Chains 自动为构建的镜像生成签名。
  2. 使用 buildah Tekton 任务构建镜像。
  3. (可选)使用 cosign CLI 验证签名。
  4. 配置 Kyverno 规则,仅允许已签名的镜像。
  5. 使用该镜像创建 Pod 以验证签名。
TIP

与快速开始:签名的 Provenance相比,此方法仅增加了更多的验证步骤。

#使用场景

以下场景需要参考本文档中的指导:

  • 在 Kubernetes 集群中使用 Kyverno 实现镜像签名验证
  • 强制安全策略,仅允许已签名的镜像部署
  • 在 CI/CD 流水线中设置自动镜像签名验证
  • 确保生产环境中镜像的完整性和真实性
  • 为容器镜像实施供应链安全控制

#前提条件

  • 已安装 Tekton Pipelines、Tekton Chains 和 Kyverno 的 Kubernetes 集群
  • 支持镜像推送的镜像仓库
  • 已安装并配置好访问集群的 kubectl CLI
  • 已安装 cosign CLI 工具
  • 已安装 jq CLI 工具

#流程概览

步骤操作说明
1生成签名密钥使用 cosign 创建用于签名工件的密钥对
2设置认证配置镜像仓库凭证以支持镜像推送
3配置 Tekton Chains设置 Chains 使用 OCI 存储并配置签名
4创建示例流水线创建包含必要任务和工作空间的流水线定义
5运行示例流水线创建并运行配置正确的 PipelineRun
6等待签名等待 PipelineRun 被 Chains 签名
7获取镜像信息从 PipelineRun 中提取镜像 URI 和摘要
8使用 Kyverno 验证签名配置并使用 Kyverno 策略验证镜像签名
9清理资源删除测试 Pod 和策略

#逐步操作说明

#步骤 1-7:基础设置

这些步骤与快速开始:签名的 Provenance指南相同。请按照该指南中的说明完成:

  • 步骤 1:生成签名密钥
  • 步骤 2:设置认证
  • 步骤 3:配置 Tekton Chains
  • 步骤 4:创建示例流水线
  • 步骤 5:运行示例流水线
  • 步骤 6:等待 PipelineRun 签名
  • 步骤 7:从 PipelineRun 获取镜像

#步骤 8:使用 Kyverno 验证签名

在步骤 8:验证镜像和证明中,我们使用 cosign CLI 验证签名。 这里我们改用 Kyverno 来验证签名。

#步骤 8.1:创建 Kyverno 策略,仅允许已签名的镜像部署

TIP

此步骤需要集群管理员权限。

有关 Kyverno ClusterPolicy 的更多详情,请参阅 Kyverno ClusterPolicy

策略内容如下:

apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
  name: only-cosign-image-deploy
spec:
  webhookConfiguration:
    failurePolicy: Fail
    timeoutSeconds: 30
  background: false
  rules:
    - name: check-image
      match:
        any:
          - resources:
              kinds:
                - Pod
              namespaces:
                - policy
      verifyImages:
        - imageReferences:
            - "*"
            # - "<registry>/test/*"
          skipImageReferences:
            - "ghcr.io/trusted/*"
          failureAction: Enforce
          verifyDigest: false
          required: false
          useCache: false
          imageRegistryCredentials:
            allowInsecureRegistry: true
            secrets:
              # 凭证需要存在于 Kyverno 所部署的命名空间中
              - registry-credentials

          attestors:
            - count: 1
              entries:
                - keys:
                    publicKeys: |- # <- 签名者的公钥
                      -----BEGIN PUBLIC KEY-----
                      MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEFZNGfYwn7+b4uSdEYLKjxWi3xtP3
                      UkR8hQvGrG25r0Ikoq0hI3/tr0m7ecvfM75TKh5jGAlLKSZUJpmCGaTToQ==
                      -----END PUBLIC KEY-----

                    ctlog:
                      ignoreSCT: true

                    rekor:
                      ignoreTlog: true

:::details {title="YAML 字段说明"}

  • spec.rules[].match.any[].resources:匹配并验证的资源。
    • kinds:匹配并验证的资源类型。
      • Pod:Pod 资源。
    • namespaces:匹配并验证的资源所在命名空间。
      • policy:匹配并验证 policy 命名空间中的资源。
  • spec.rules[].verifyImages:需要验证的镜像
    • imageReferences:需要验证的镜像引用。
      • *:验证所有镜像引用。
      • <registry>/test/*:仅验证 <registry>/test 仓库中的镜像引用。
    • skipImageReferences:跳过验证的镜像引用。
      • ghcr.io/trusted/*:跳过 ghcr.io/trusted 仓库中的镜像引用。
    • imageRegistryCredentials:
      • allowInsecureRegistry:是否允许不安全的仓库。
      • secrets:用于镜像仓库凭证的 secret。
        • registry-credentials:secret 名称,需存在于 Kyverno 所部署的命名空间。
    • attestors:用于镜像验证的验证者。
      • count:需要匹配的验证者数量。
      • entries:验证者条目。
        • keys:验证者的密钥。
          • publicKeys:验证者的公钥。
            • 此公钥与 signing-secrets secret 中的 cosign.pub 公钥相同。
          • ctlog:验证者的 ctlog。
            • ignoreSCT:是否忽略 SCT。
              • 在隔离网络环境中,先忽略 SCT。
          • rekor:验证者的 rekor。
            • ignoreTlog:是否忽略 Tlog。
              • 在隔离网络环境中,先忽略 Tlog。 :::

需要调整配置

  • spec.rules[].attestors[].entries[].keys.publicKeys:签名者的公钥。
    • 此公钥与 signing-secrets secret 中的 cosign.pub 公钥相同。
    • 公钥可从获取签名公钥部分获得。

保存为名为 kyverno.only-cosign-image-deploy.yaml 的 yaml 文件,并通过以下命令应用:

$ kubectl apply -f kyverno.only-cosign-image-deploy.yaml

clusterpolicy.kyverno.io/only-cosign-image-deploy configured

#步骤 8.2:验证策略

在定义策略的 policy 命名空间中,创建一个 Pod 来验证该策略。

使用流水线创建的已签名镜像创建 Pod。

$ export NAMESPACE=<policy>
$ export IMAGE=<<registry>/test/chains/demo-1:latest@sha256:93635f39cb31de5c6988cdf1f10435c41b3fb85570c930d51d41bbadc1a90046>

$ kubectl run -n $NAMESPACE signed --image=${IMAGE} -- sleep 3600

pod/signed created

Pod 会成功创建。

$ export NAMESPACE=<policy>
$ kubectl get pod -n $NAMESPACE signed

NAME      READY   STATUS    RESTARTS   AGE
signed   1/1     Running   0          10s

使用未签名镜像创建 Pod。

$ export NAMESPACE=<policy>
$ export IMAGE=<<registry>/test/chains/unsigned:latest>

$ kubectl run -n $NAMESPACE unsigned --image=${IMAGE} -- sleep 3600

收到如下输出,表示 Pod 被策略阻止。

Error from server: admission webhook "mutate.kyverno.svc-fail" denied the request:

resource Pod/policy/unsigned was blocked due to the following policies

only-cosign-image-deploy:
  check-image: 'failed to verify image ubuntu:latest:
    .attestors[0].entries[0].keys: no signatures found'

#步骤 9:清理资源

删除前面步骤中创建的 Pod。

$ export NAMESPACE=<policy>
$ kubectl delete pod -n $NAMESPACE signed

pod "signed" deleted

删除策略。

$ kubectl delete clusterpolicy only-cosign-image-deploy

#预期结果

完成本指南后:

  • 您已成功搭建 Tekton Chains 进行镜像签名,Kyverno 进行签名验证的环境
  • 容器镜像在构建过程中自动签名
  • 仅允许已签名的镜像在指定命名空间中部署
  • 未签名镜像会被 Kyverno 策略自动阻止
  • 实现了容器镜像的基础供应链安全控制

本指南为在 CI/CD 流水线中实现供应链安全提供了基础。在生产环境中,您应当:

  1. 配置合理的命名空间隔离和访问控制
  2. 实施安全的签名密钥管理
  3. 设置策略违规的监控和告警
  4. 定期轮换签名密钥并更新安全策略
  5. 考虑实施漏洞扫描等额外安全控制

#参考资料

  • Chains Signed Provenance Tutorial
  • Chains Configuration