CI/CD / 系统课时

用表达式控制步骤是否执行

用表达式控制步骤是否执行

同一条流水线通常不应在所有事件、分支和前序状态下执行完全相同的步骤。本节通过一个可手动验证的工作流,使用表达式与 if 控制执行路径,并解释多个条件、成功状态和失败后处理的边界。

学习目标

  • 使用 if 根据事件、分支和运行数据决定步骤是否执行
  • 用 &&、|| 和比较运算组合多个条件
  • 正确使用 success()、failure() 和 always() 处理前序执行结果

if 在步骤运行前做判断

Step 的 if 条件为真时才执行该步骤,为假时该步骤会被跳过。条件可以读取 github 等 contexts,因此很适合表达“只在某种触发方式或某条分支执行”的规则。

例如下面的条件要求事件是 push,并且当前引用是 main:

yaml
if: github.event_name == 'push' && github.ref == 'refs/heads/main'

这是片段示例,需要放在 Job 或 Step 等支持 if 的位置。这里可以省略 ${{ }},因为 if 字段会自动按表达式求值;在其他字段中引用表达式时,通常仍需要 ${{ ... }}。

用一个工作流观察执行路径

下面的工作流支持手动触发,并通过输入值模拟是否让测试步骤失败。这样无需修改代码,就能观察普通条件和状态检查函数如何改变后续步骤。

yaml
name: Expression demo

on:
  workflow_dispatch:
    inputs:
      fail_test:
        description: Fail the test step
        required: true
        type: boolean
        default: false

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - name: Show manual trigger
        if: github.event_name == 'workflow_dispatch'
        run: echo "manual trigger"

      - name: Run simulated test
        run: |
          if [ "${{ inputs.fail_test }}" = "true" ]; then
            echo "test failed"
            exit 1
          fi
          echo "test passed"

      - name: Run after success
        if: ${{ success() }}
        run: echo "previous steps succeeded"

      - name: Report failure
        if: ${{ failure() }}
        run: echo "a previous step failed"

      - name: Always clean up
        if: ${{ always() }}
        run: echo "cleanup"

当 fail_test 使用默认值 false 时,预期输出中的关键内容为:

text
manual trigger
test passed
previous steps succeeded
cleanup

当把 fail_test 设为 true 时,模拟测试返回非零退出码,Run after success 被跳过,关键输出变为:

text
manual trigger
test failed
a previous step failed
cleanup

GitHub Actions 日志还会包含 Runner 自身生成的信息,因此实际日志不会只有上述几行;验证时关注这些步骤是否执行以及对应文本即可。

GitHub Actions 条件执行与状态分支

状态检查函数不是普通布尔变量

没有显式状态检查函数时,后续步骤通常隐含成功状态要求。因此,当你希望失败后仍运行诊断逻辑时,应明确使用 failure();希望无论前序结果如何都执行时,可以使用 always()。

always() 常用于必须尝试执行的收尾动作,但不要因此把所有清理逻辑都无条件化。某些操作依赖前一步生成的文件或资源,执行前仍应检查必要条件,否则原始故障之后还可能产生新的无关错误。

组合条件时保持可读性

表达式支持 ==、!=、&&、|| 和 ! 等常用运算。条件开始变长时,不要为了少写一个 Step 而堆叠大量逻辑;部署、发布、诊断等职责差异明显的路径更适合拆成独立 Step 或 Job。

判断一个 if 是否清晰,可以直接把它读成一句话:在什么事件或分支下,并且前序处于什么状态时,执行什么动作。只要这句话开始出现多个难以追踪的分支,就应该拆分执行路径,而不是继续扩展单个表达式。

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

目录与阅读设置

阅读设置

17

记录一个想法

用表达式控制步骤是否执行

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

登录哪都通