Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

分支

一个步骤可以有多个分支。第一个分支需要设置分支条件,当分支执行时,根据条件确定执行哪一个分支。当有多个条件满足时,满足条件的分支并行执行。

name: test
steps:
    - id: step1
      branches:
        - id: b1
          # 分支条件表达式
          if: '${{ a }} > 0'
          steps:
            - id: step2

        - id: b2
          # 默认分支
          # 当其他条件全为 false 时执行
          steps:
            - id: step3
    - id: step4

分支包含的属性有:

key名 称说 明
id标识节点的唯一标识
name名称有意义的名称,可以是中文等任意字符
tag标签标签设置
if条件分支条件表达式,使用 ${{ var }} 语法引用变量
needs前置前置分支id列表,只有前置分支完成后才执行当前分支,可以通过 needs 将分支执行线性化
vars变量本地变量定义
steps步骤列表分支内的步骤列表
inputs输入输入schema定义
outputs输出输出schema定义

分支前置依赖 (needs)

当分支设置了 needs 后,该分支会进入 Pending 状态,等待前置分支完成后再执行:

branches:
    - id: b1
      if: 'true'
      name: 分支1
      steps:
        - id: step11
          uses: acts.core.irq
          params:
            key: act1

    - id: b2
      if: 'true'
      name: 分支2
      needs:
        - b1
      steps:
        - id: step21