CI/CD / 系统课时

固定第三方 Action 的版本

固定第三方 Action 的版本

工作流中的第三方 Action 本质上也是构建与部署链路中的代码依赖。若版本引用可以被远端重新指向,同一份工作流在不同时间可能执行不同代码。本篇建立可审计的引用方式,并说明标签、分支和完整提交 SHA 的取舍。

学习目标

  • 理解第三方 Action 可变引用带来的供应链风险
  • 区分分支、版本标签与完整提交 SHA 的可审计性
  • 使用完整提交 SHA 固定关键第三方 Action,并保留版本来源信息

uses 引用决定实际执行什么

工作流通过 uses 指定 Action 及其 Git 引用。例如下面三个写法看起来都指定了版本,但稳定性并不相同:

yaml
steps:
  - uses: owner/action@main
  - uses: owner/action@v3
  - uses: owner/action@0123456789abcdef0123456789abcdef01234567

这是片段示例,需要放在 GitHub Actions job 的 steps 中。main 是分支引用,v3 通常是维护者提供的标签,而最后一项表示一个完整的 40 位 Git 提交 SHA。示例 SHA 仅用于展示格式,不对应真实 Action 版本。

分支和标签便于升级,但引用指向可能变化;完整提交 SHA 直接锁定具体提交,因此更适合要求可复现和可审计的生产流水线。

为什么完整提交 SHA 更适合关键流水线

当第三方 Action 参与发布、云平台认证、制品签名或生产部署时,它往往能够读取代码、使用令牌,甚至接触部署凭据。如果引用的是可移动标签,而该引用后来指向不同提交,工作流下一次运行时执行的代码也会变化。

第三方 Action 不同版本引用的供应链边界

固定 SHA 的价值不是保证第三方代码天然安全,而是把“这次执行哪一份代码”固定下来。审查者可以围绕确定的提交进行代码审计、来源核验和升级评估。

在工作流中固定 Action

假设已经从 Action 的官方仓库核实目标版本对应的提交 SHA,可以把工作流写成下面的形式。这里仍使用格式占位值,实际配置必须替换为经过核验的真实 SHA。

yaml
name: CI

on:
  push:
    branches:
      - main

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Check out repository
        uses: actions/checkout@0123456789abcdef0123456789abcdef01234567 # replace with verified SHA

      - name: Run verification
        run: echo "Workflow reached verification step"

这是配置示例,其中 SHA 仅演示固定格式,不能直接作为有效的 actions/checkout 版本使用。实际使用时,应从可信来源核实目标 release 或 tag 对应的完整提交 SHA,再替换示例值。

替换为真实 SHA 后推送工作流,并确认 job 能执行到验证步骤。预期输出为:

text
Workflow reached verification step

实际日志还会包含 checkout 和 runner 的其他输出,时间等动态信息可能不同。

标签与 SHA 怎么取舍

@main 或其他分支适合主动跟随开发进度的场景,但不适合作为高敏感生产流水线的稳定依赖。@v3、@v3.2.1 之类标签更容易阅读和升级,却仍需要考虑标签是否可能被维护者重新指向。

完整提交 SHA 提供最明确的固定点,代价是可读性下降、升级需要显式修改。实践中可以在 SHA 后添加普通 YAML 注释,记录它对应的人类可读版本,方便代码评审和后续升级,例如 # v4.2.0。注释只是维护信息,真正决定执行代码的仍然是 SHA。

把版本更新变成可审查的变更

固定 SHA 后,升级不再是远端标签悄悄移动,而会表现为仓库中的工作流 diff。评审者可以核对旧 SHA、新 SHA、对应 release,以及 Action 权限或行为是否发生变化。

对生产部署、制品发布和凭据访问链路,优先把第三方 Action 固定到经过核验的完整提交 SHA;对风险较低且需要自动跟随更新的场景,再根据维护成本选择标签。这样版本策略本身就成为流水线供应链控制的一部分。

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

目录与阅读设置

阅读设置

17

记录一个想法

固定第三方 Action 的版本

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

登录哪都通