上线的还是 CI 构建的那一个包吗?用 GitHub Actions 构建证明反查

文章封面

发布单写着镜像版本 v1.8.0,GitHub Actions 的那次构建也通过。可真正运行的容器是这个工作流产出的吗?如果有人后来把同一个标签指向了另一份镜像,页面上还是那串版本号。要能追溯,第一步是从运行实例拿到实际制品身份。

构建证明把制品摘要和可验证的构建来源放在一起。本文用一个同时发布二进制和镜像的示例团队,分别说明生成、验证和落地。示例的仓库名与路径需换成自己的,演练操作针对自有制品。

同一个版本名可以有两件制品

团队构建 app-linux-amd64 文件,另聚合两个平台的容器镜像。二进制打包前后是不同文件,摘要自然不同。若要在部署端验证最终压缩包,CI 应对最终压缩包签发证明。签完才改变包内权限或添加一个文件,部署端拿到的字节已经变了。镜像也类似:清单、索引与单平台镜像各有摘要。发布一个多架构索引时,准入先绑定实际拉取的索引摘要;若要从实例反查,还需知道其运行的平台清单在索引里对应哪一个摘要。

将构建完成的制品、摘要和证明放在同一发布事件中管理。签发步骤拿必要的权限,部署凭据属于独立阶段。可复用工作流由平台团队维护时,组织需要清楚定义应用来源和可信签发工作流。只确认「组织内某个仓库签过」有时会放得太宽。先制定可信列表,再把它翻译成 CLI 或部署策略里的具体选项。

证明回答来源问题,部署同时核对组织策略与测试结果。

gh attestation verify ./app-linux-amd64   --repo example-org/example-app

这条命令验证文件与期望仓库相关的证明。生产准入可以进一步按 CLI 支持的来源引用、来源提交和工作流条件收紧,并将输出绑定到实际要部署的摘要。把验证和部署之间传递的参数设为同一个不可变标识。校验后把摘要改回标签就会在两步之间丢掉这份保证。

把失败原因交给真正能处理的人

设想部署失败显示「未找到证明」。有可能确实拿错了文件,也可能验证程序找错仓库或制品尚未同步。先从部署目标取出 immutable digest,核对构建输出是否已有同一个摘要,再看是否附有可访问的证明。只有摘要一致,才值得继续排身份。若摘要不一致,说明中途可能又压缩了一次或改了镜像索引。重新签发或重建都要发生在已授权构建链上,不能为了让生产变绿在部署机上临时生成一份新证明。

几个月后,构建工作流换了路径,过去的制品并没有随之变成另一份。可在发布策略里有意保留已验证过的历史版本目录与审批期。回退时复查实际待运行摘要和历史记录,同时明确当前政策是否仍允许这份构建。工单按摘要索引,比按 v1.8.0 这样可能重复的标签更可信。多个环境需要同一个制品时,也用同一摘要逐步推进,不在各环境分别构建一份看似一样的包。

准入服务自己的失败也要被观察。每次拒绝至少记录摘要、期望来源与规则命中原因。日志避免记录短期凭据。制品来源缺失、工作流变化、服务不可达要分别告警。把这条链留给接班同事,他就能决定是找构建团队、调整授权策略,还是暂停发布并让网络值班查平台问题。

交接时再核对一种容易被漏掉的制品。向客户直接分发的 ZIP 和在测试环境拉取的镜像,可能从同一次提交构建,却经历两套发布工具。两者各绑定自己的摘要与证明,避免用镜像通过准入推断下载包也匹配。下次工单可以让客户先提供文件校验和,在不交换私密日志的情况下就完成第一轮定位。

建一条反查链,随后做三个失败样例

从测试环境的一个实例抄下实际运行的摘要,回查制品仓库、发布工单和 CI 输出。确认工单里的制品能被证明验证,而且工作流身份符合目前配置。然后在自己的测试制品中依次演练这三种情况。

  1. 将构建产物复制到测试目录,改一个无害文件字节。检查验证预期拒绝,记录发现的是摘要变化还是证明缺失。
  2. 给另一条授权范围不同的测试构建流程出一份合法证明。验证它的签名可以成立,但当前部署策略应该拒绝不在可信范围的来源。
  3. 让测试网络无法访问验证所需服务。观察发布队列是立即停止,还是进入允许有限时长的可复核流程。准备用于回退的历史已批准摘要与所需的官方离线验证材料,按组织政策测一次故障场景。

三条记录要能从已部署版本反向读出来,不只留在 CI 执行日志。保留版本工单、批准来源、运行环境、实际摘要及对应的策略版本。团队换工作流文件或构建器时,新的身份上线前先在告警阶段观察一次。紧急回退可能沿用当时的可信构建证明,相关复核流程要有文件可循。

最后有一点容易误会。构建证明可以说明制品从哪来,程序正确性仍由测试和审查回答,依赖风险由另一套扫描与处置流程回答。部署记录把这些证据汇合到同一个摘要。过几个月收到一条问题报告,值班人员从运行实例就能反查当时哪个提交、哪条工作流和哪些门槛允许该制品进入生产。

参考资料

GitHub 构建证明概念 · GitHub 生成与验证制品证明 · GitHub CLI 验证选项

评论

暂无评论