签名的来源证明
本指南帮助新用户快速设置 Tekton Chains,通过为 Tekton PipelineRuns 生成并验证 SLSA Provenance 来保护其 CI/CD 流水线。
目录
简介使用场景预计阅读时间重要说明前提条件流程概览分步说明步骤 1:生成签名密钥步骤 2:设置身份验证步骤 3:配置 Tekton Chains步骤 4:创建示例流水线步骤 5:运行示例流水线步骤 6:等待 PipelineRun 签名步骤 7:从 PipelineRun 获取镜像步骤 8:验证镜像和 Attestation预期结果参考资料简介
使用场景
Tekton Chains 可通过自动为构建产物生成 SLSA Provenance,帮助您保护软件供应链。本指南演示如何设置 Tekton Chains、生成签名密钥、运行示例流水线,以及验证其 SLSA Provenance。
预计阅读时间
15-20 分钟
重要说明
- 使用 Alauda Container Platform Pipelines Operator 时,Tekton Chains 默认安装在
tekton-pipelines命名空间中 - 应安全管理签名密钥;在生产环境中,请考虑使用密钥管理系统(KMS)
- 本指南通过在流水线中内联生成 Containerfile,采用了简化的工作流
- 在生产环境中,您应使用适当的源代码管理和版本控制
前提条件
- 已安装 Tekton Pipelines 和 Tekton Chains 的 Kubernetes 集群
- 已启用镜像推送功能的 registry
- 已安装并配置为可访问集群的
kubectlCLI - 已安装
cosignCLI 工具 - 已安装
jqCLI 工具
流程概览
分步说明
步骤 1:生成签名密钥
有关更多详细信息,请参阅签名密钥配置
Tekton Chains 使用加密密钥对构建产物进行签名。默认情况下,它会在 Chains 命名空间中查找名为 signing-secrets 的 Secret。
-
如果尚未安装,请安装 cosign
-
生成密钥对并将其存储为 Kubernetes Secret。除非 Secret 是不可变的,否则该命令会替换
signing-secrets已持有的密钥对(对于不可变 Secret,该命令会失败),因此请先阅读生成签名密钥。该命令会在tekton-pipelines中写入一个 Secret,因此需要具备该位置对应的权限,通常需要集群管理员权限。单独运行read -rs行,输入密码并按 Enter:read -rs不会显示密码,因此密码不会出现在屏幕上或 shell 历史记录中:然后运行:
cosign命令会输出:TIP此密码将存储在
tekton-pipelines命名空间中名为signing-secrets的 Kubernetes Secret 中。 -
验证 Secret 是否已创建:
步骤 2:设置身份验证
有关更多详细信息,请参阅 Chains 的身份验证
配置用于推送镜像的 registry 凭据。首先设置流水线运行所在的命名空间以及 PipelineRun 使用的 service account;步骤 5 使用相同的两个值:
-
创建包含凭据的 Secret。单独运行
read -rs行,输入 registry 密码并按 Enter;read -rs不会显示密码:然后运行:
-
设置
config.json键: -
修改 service account,使其使用该 Secret:
步骤 3:配置 Tekton Chains
有关更多详细信息,请参阅 Chains 配置
配置 Tekton Chains,以 OCI 格式存储构建产物。此补丁会更改整个集群的 Chains 设置,而不是单个命名空间的设置。它需要修改 TektonConfig 的权限;该资源的作用域为集群,通常需要集群管理员权限:
步骤 4:创建示例流水线
这是一个 Pipeline 资源,用于构建镜像并生成 SLSA Provenance attestation。
在生产环境中,应该:
- 使用
git-clonetask 从代码仓库获取源代码 - 使用源代码中已有的 Containerfile 构建镜像
- 这种方式可以确保正确的版本控制,并保持代码与流水线配置之间的分离
Explanation of YAML fields
params:流水线的参数。generate-containerfile:用于生成构建镜像所需 Containerfile 的脚本。image:构建的目标镜像地址。
tasks:流水线的 tasks。generate-containerfile:用于生成构建镜像所需 Containerfile 的 task。build-image:用于构建镜像并将其推送到 registry 的 task。params.TLS_VERIFY:构建步骤是否验证 registry 的 TLS 证书。"false"用于集群不信任其证书的测试 registry;如果证书受信任,请设置为"true"。该参数会影响构建步骤:Chains 针对这类 registry 有自己的设置storage.oci.repository.insecure(请参阅 Chains 配置),步骤 8 中的cosign则包含--allow-insecure-registry标志。params.CONTAINERFILE:要构建的 Containerfile 路径,即generate-containerfiletask 写入的文件。
results:流水线的结果。first_image_ARTIFACT_OUTPUTS:第一个镜像构建产物输出的结果。digest:镜像的摘要。uri:镜像的 URI。
- 此格式符合 Tekton Chains,请参阅上文中的 Tekton Chains 类型提示 了解更多详细信息。
workspaces:流水线的工作区。source:源代码工作区。registryconfig:分发 registry 配置工作区。
需要调整的配置
params:generate-containerfiledefault:调整源镜像地址。
image:default:构建的目标镜像地址。
保存到名为 chains.demo-1.pipeline.yaml 的 yaml 文件中,并使用以下命令应用:
步骤 5:运行示例流水线
这是一个 PipelineRun 资源,用于运行流水线。
Explanation of YAML fields
pipelineRef:要运行的流水线。name:流水线的名称。
taskRunTemplate:task run 模板。serviceAccountName:流水线使用的 service account。
workspaces:流水线的工作区。registryconfig:分发 registry 配置工作区。source:源代码工作区。
需要调整的配置
taskRunTemplate:serviceAccountName:上一步准备的 service account,请参阅ServiceAccount 配置。
workspaces:registryconfig:secret.secretName:上一步准备的 registry Secret,请参阅创建 registry 凭据。
source:volumeClaimTemplate.spec.storageClassName:卷声明模板的存储类名称。
保存到名为 chains.demo-1.pipelinerun.yaml 的 yaml 文件中,并使用以下命令应用:
等待 PipelineRun 完成。
步骤 6:等待 PipelineRun 签名
等待 PipelineRun 具有 chains.tekton.dev/signed: "true" 注释。
chains.tekton.dev/signed: "true" 注释表示 Chains 已处理该 PipelineRun。它不能证明镜像已签名;请在步骤 8中验证签名。
步骤 7:从 PipelineRun 获取镜像
此镜像将用于验证签名。
步骤 8:验证镜像和 Attestation
-
获取签名公钥
如果没有相应权限,可以请求管理员获取公钥。
-
验证签名
步骤 3 未设置
transparency.enabled,并且使用默认的false时,Chains 不会将签名或 attestation 上传到透明日志。请在运行这些命令的 shell 中告知cosign,跳过对本步骤中cosign命令的透明日志检查:如果成功,您将看到以下输出:
-
验证 SLSA provenance attestation
如果成功,您将看到以下输出:
上面的示例显示了一行 attestation,但在此快速入门中,该命令会输出两行:一行对应
build-imagetask 的TaskRun,另一行对应PipelineRun;因此下一项中的命令会输出两个 payload,示例显示的是TaskRun的 payload。 -
使用 jq 提取 payload:
Attestation Payload
预期结果
完成本指南后:
- 您将拥有一个配置了 signing key 的可用 Tekton Chains 设置
- 您的 PipelineRuns 在完成时会自动进行签名,并且 image 具有 SLSA Provenance attestation
- 您可以验证签名和 attestations,以确保构建的完整性
本指南为在 CI/CD pipelines 中实施供应链安全提供了基础。在生产环境中,您应当:
- 使用适当的源代码管理和版本控制
- 使用 cloud KMS 实施安全的密钥管理
- 在部署流程中设置自动验证
- 配置适当的访问控制和安全策略
- 定期轮换 signing keys 并更新安全配置