条件分支

GCS支持条件分支功能，基础原理是 根据每个步骤的condition字段来判断当前步骤是否执行。根据业务使用场景分为简单条件分支和复杂条件分支。

• 简单条件分支，即在流程执行前，已经确定某个值是true还是false，从而可以确定对应的步骤是否需要执行。一般情况下，简单条件分支适用于condition字段，后跟布尔类型的值，做为判断。
• 复杂条件分支，即在流程执行过程中，根据流程执行的结果才能判断对应的步骤是否需要执行。一般情况下，复杂条件分支可以使用check_result函数来判断执行结果，并配合condition字段确定对应的步骤是否需要执行。

如下示例中，如果job-a的condition值为false，则commands命令不会执行。

inputs:
  bool-var:
    default: true
    description: 布尔值输入变量
    type: bool
workflow:
  job-a:
    tool: nginx:latest
    condition: ${bool-var}  # <==通过变量，决定步骤是否执行。相当于 if（bool-var）
    commands:
      - echo run-job-a

因为需要根据上一个步骤的“执行结果”来判断下一步骤的condition值是true还是false，所以GCS使用了check_result函数来动态判断。

图1 复杂条件分支示例

如下示例中，job-a的结果为pass，则job-b将会执行，job-c和job-d不会执行。

workflow:
  job-a:
    tool: nginx:latest
    commands:
      - echo pass  # <== 执行结果以标准std_out体现
  job-b:
    tool: nginx:latest
    condition: check_result(job-a, "pass")  # <==判断job-a的结果，等于pass才执行。
    commands:
      - echo run-job-b
  job-c:
    tool: nginx:latest
    condition: check_result(job-a, "npass")  # <==判断job-a的结果，等于npass才执行。
    commands:
      - echo run-job-c
  job-d:
    tool: nginx:latest
    condition: check_result(job-a, "failed")  # <==判断job-a的结果，等于failed才执行。
    commands:
      - echo run-job-d

check_result的第二个参数可以使用 inputs变量，详细请参见check_result函数。示例如下：

condition: check_result(job-a, ${my_var})

所以不需要为每个Job重复写condition条件，GCS自动会判断依赖传递。