CI/CD / 系统课时
取消同分支的过期运行
取消同分支的过期运行
开发者连续向同一分支推送提交时,旧提交触发的 CI 往往已经失去价值,却仍会占用 Runner。GitHub Actions 的 concurrency 可以把相关运行归入同一并发组,并在新运行到来时取消该组中过期的进行中运行。
学习目标
- 理解
concurrency如何划分互相竞争的运行 - 配置同一分支只保留最新运行
- 避免错误的分组键导致无关分支互相取消
为什么旧运行应该取消
假设 feature/login 在短时间内连续推送 A、B、C 三个提交。如果三个工作流都完整执行,A 和 B 的测试结果很可能在产生时已经过时;若工作流还包含预览环境部署,它们甚至可能争抢同一环境。
concurrency 解决的是这种“新运行已经替代旧运行”的资源竞争。它通过一个分组键识别哪些运行属于同一竞争组,再由 cancel-in-progress 决定新运行出现时是否取消组内正在执行的旧运行。

为每个工作流和分支建立并发组
下面的工作流把工作流名称与 Git 引用组合为并发组。这样同一工作流、同一分支或标签的运行会竞争,而不同分支不会因为组名相同而互相取消。
name: CI
on:
push:
pull_request:
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
jobs:
test:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Run checks
run: echo "Checking $GITHUB_SHA"预期输出
Checking <ID><ID> 代表当前运行对应的提交 SHA,实际值每次不同。如果同一并发组的新运行在旧运行结束前到达,旧运行会被取消,因此它不保证执行到最后一步。
分组键决定取消范围
group 不是显示名称,而是并发隔离边界。只写固定值会让所有匹配该工作流配置的运行进入同一组;加入 github.ref 后,分支或标签引用不同的运行可以分开竞争。
例如 CI-refs/heads/feature/login 与 CI-refs/heads/feature/search 属于不同组,因此两个功能分支可以并行运行。同一个 feature/login 上的新提交则会复用相同组,从而淘汰旧运行。
部署任务要按资源选择分组
CI 测试通常关注“同一分支只验证最新提交”,但部署的竞争边界可能是目标环境。例如多个分支都能部署到同一个 staging 环境时,真正需要串行化或淘汰的对象是 staging,而不是各自的分支。
因此应先回答“哪些运行不能同时继续”,再设计 group。分支测试可以使用工作流加引用,环境部署则可以把目标环境纳入分组键。cancel-in-progress: true 也不是所有任务都适用:数据库迁移、发布或其他不可安全中断的操作,需要先确认中途取消不会留下不一致状态。
配置完成后,可以连续向同一测试分支推送两个提交进行验证:第二次运行开始后检查 Actions 运行记录,旧运行应进入取消状态,而其他分支的运行不应受到影响。这样既验证了取消行为,也验证了分组边界没有设置得过宽。