CI/CD / 系统课时

签名与验证发布制品

签名与验证发布制品

本课把镜像签名接入发布链路:构建后只对不可变摘要签名,部署前同时校验签名、摘要和来源。完成后,流水线能把“谁发布了什么”变成可验证的门禁,而不是只依赖镜像标签或仓库权限。

学习目标

  • 理解签名、镜像摘要与可信来源之间的关系
  • 使用 Cosign 对镜像摘要签名并在部署前验证
  • 为验证失败、来源不符和标签漂移设置拒绝部署策略

把签名放在发布链路的正确位置

签名应发生在构建、测试和安全扫描通过之后,并绑定已经推送到仓库的不可变 digest。部署阶段不要重新“相信”某个可变标签,而应取得计划部署的 repository@sha256:<DIGEST>,再执行验证门禁。

发布制品签名与部署验证链路

签名本身不会证明制品“没有漏洞”,它证明的是某个可信身份或密钥对某个具体摘要做过签署。因此,扫描结果、构建来源和签名验证是不同门禁,不能互相替代。

用不可变摘要作为验证对象

镜像标签如 release、v1 仍可能被重新指向其他内容,而 digest 由镜像内容确定。发布记录应保存完整镜像引用、提交号、流水线运行 ID 和签名者信息,部署清单也优先固定到 digest。

一个最小门禁至少要回答三件事:当前镜像是否来自允许的仓库路径;当前 digest 是否就是审批过的 digest;该 digest 是否由预期的签名者签署。任一条件不满足,都不应继续部署。

签名并设置部署门禁

下面以 Cosign 的本地密钥对演示核心动作。示例假设 cosign.key 与 cosign.pub 已安全准备好、镜像已推送,且 COSIGN_PASSWORD 由 CI 的受保护 Secret 注入。生产环境更适合把私钥放入 KMS/HSM,或使用受约束的无密钥身份,避免把长期私钥文件留在 Runner。

bash
#!/usr/bin/env bash
set -euo pipefail

IMAGE="registry.example.com/team/app@sha256:<DIGEST>"
: "${COSIGN_PASSWORD:?inject COSIGN_PASSWORD as a masked CI secret}"

case "$IMAGE" in
  registry.example.com/team/app@sha256:*) ;;
  *) echo "untrusted image source" >&2; exit 2 ;;
esac

cosign sign --key cosign.key "$IMAGE" >/dev/null
cosign verify --key cosign.pub "$IMAGE" >/dev/null

echo "signature verified"

预期输出

text
signature verified

实际 digest、签名存储位置和 Cosign 的诊断信息会因仓库与版本不同;脚本只把验证成功后的稳定结果输出出来。只要签名验证失败,set -e 就会让任务立即失败,后续部署步骤不会执行。

可信来源不只是一把公钥

如果使用本地公钥验证,要保证 cosign.pub 的分发路径独立可信,不能让待部署仓库中的制品同时携带并决定“应该信任哪把公钥”。使用 OIDC/无密钥签名时,则要固定允许的身份、颁发者和仓库范围,而不是接受任意可验证证书。

让验证失败真正阻断发布

验收时至少测试三种负向场景:把 digest 改成未签名制品、改成其他仓库的同名镜像、使用错误公钥或错误身份。三种情况都应在部署之前失败,并留下可追踪的验证日志。

最终目标不是“流水线里出现了签名命令”,而是任何进入目标环境的制品都能回答来源、摘要和签名者三个问题,并且验证失败时没有绕过部署门禁的路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

签名与验证发布制品

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通