CI/CD / 系统课时

取消同分支的过期运行

取消同分支的过期运行

开发者连续向同一分支推送提交时,旧提交触发的 CI 往往已经失去价值,却仍会占用 Runner。GitHub Actions 的 concurrency 可以把相关运行归入同一并发组,并在新运行到来时取消该组中过期的进行中运行。

学习目标

  • 理解 concurrency 如何划分互相竞争的运行
  • 配置同一分支只保留最新运行
  • 避免错误的分组键导致无关分支互相取消

为什么旧运行应该取消

假设 feature/login 在短时间内连续推送 A、B、C 三个提交。如果三个工作流都完整执行,A 和 B 的测试结果很可能在产生时已经过时;若工作流还包含预览环境部署,它们甚至可能争抢同一环境。

concurrency 解决的是这种“新运行已经替代旧运行”的资源竞争。它通过一个分组键识别哪些运行属于同一竞争组,再由 cancel-in-progress 决定新运行出现时是否取消组内正在执行的旧运行。

同分支过期运行取消流程

为每个工作流和分支建立并发组

下面的工作流把工作流名称与 Git 引用组合为并发组。这样同一工作流、同一分支或标签的运行会竞争,而不同分支不会因为组名相同而互相取消。

yaml
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"

预期输出

text
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 运行记录,旧运行应进入取消状态,而其他分支的运行不应受到影响。这样既验证了取消行为,也验证了分组边界没有设置得过宽。

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

目录与阅读设置

阅读设置

17

记录一个想法

取消同分支的过期运行

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

登录哪都通