条件判断

    在 KubeVela 工作流中，每个步骤都可以指定一个 ，你可以使用 if 来确定是否应该执行该步骤。

    在步骤没有指定 If 的情况下，KubeVela 会根据先前步骤的状态来判断是否应该执行该步骤。默认步骤的执行条件是：在该步骤前的所有步骤状态均为成功。

    这也意味着，如果步骤 A 执行失败，那么步骤 A 之后的步骤 B 会被跳过，不会被执行。

    部署如下例子：

    1. $ vela status err-with-no-if
    2. About:
    4.   Name:         err-with-no-if
    5.   Namespace:    default
    6.   Created at:   2022-06-24 18:14:46 +0800 CST
    7.   Status:       workflowTerminated
    9. Workflow:
    11.   mode: StepByStep
    12.   finished: true
    13.   Suspend: false
    14.   Terminated: true
    15.   Steps
    16.   - id:bztlmifsjl
    17.     name:apply-err
    18.     type:apply-object
    19.     phase:failed
    20.     message:step apply: run step(provider=kube,do=apply): Object 'Kind' is missing in '{"test":"err"}'
    21.   - id:el8quwh8jh
    22.     name:apply-comp
    23.     type:apply-component
    24.     phase:skipped
    25.     message:
    27. Services:

    可以看到，步骤 apply-err 会因为尝试部署一个非法的资源而导致失败，同时，因为之前的步骤失败了，步骤 apply-comp 将被跳过。

    如果你希望一个步骤无论如何都应该被执行，那么，你可以为这个步骤指定 if 为 always。

    部署如下例子：

    使用 vela status 命令查看应用状态：

    1. $ vela status err-with-always
    2. About:
    4.   Name:         err-with-always
    5.   Namespace:    default
    6.   Status:       workflowTerminated
    8. Workflow:
    10.   mode: StepByStep
    11.   finished: true
    12.   Suspend: false
    13.   Terminated: true
    14.   Steps
    15.   - id:loeqr6dlcn
    16.     name:comp
    17.     type:apply-component
    18.     phase:failed
    19.     message:
    20.   - id:hul9tayu82
    21.     name:notification
    22.     type:notification
    23.     phase:succeeded
    24.     message:
    26. Services:
    28.   - Name: invalid
    29.     Cluster: local  Namespace: default
    30.     Type: webservice
    31.     Unhealthy Ready:0/1
    32.     No trait applied

    你也可以编写自己的判断逻辑来确定是否应该执行该步骤。注意： if 里的值将作为 CUE 代码执行。KubeVela 在 if 中提供了一些内置变量，它们是：

    • status：status 中包含了所有工作流步骤的状态信息。你可以使用 status.<step-name>.phase == "succeeded" 来判断步骤的状态，也可以使用简化方式status.<step-name>.succeeded 来进行判断。
    • inputs：inputs 中包含了该步骤的所有 inputs 参数。你可以使用 inputs.<input-name> == "value" 来获取判断步骤的输入。

    注意，如果你的步骤名或者 inputs 名并不是一个有效的 CUE 变量名（如：包含 -，或者以数字开头等），你可以用如下方式引用：status["invalid-name"].failed

    部署如下例子：

    1. $ vela status custom-if
    2. About:
    4.   Name:         custom-if
    6.   Created at:   2022-06-25 00:37:14 +0800 CST
    8. Workflow:
    10.   mode: StepByStep
    11.   finished: true
    12.   Suspend: false
    13.   Terminated: false
    14.   Steps
    15.   - id:un1zd8qc6h
    16.     name:apply
    17.     type:apply-component
    18.     phase:succeeded
    19.     message:
    20.   - id:n5xbtgsi68
    21.     name:notification
    22.     type:notification
    23.     phase:succeeded
    24.     message:
    25.   - id:2ufd3v6n78
    26.     name:notification-skip
    27.     type:notification
    28.     phase:skipped
    29.     message:
    30.   - id:h644x6o8mb
    31.     name:notification-succeeded
    32.     type:notification
    33.     phase:succeeded
    34.     message:
    36. Services:
    38.   - Name: comp-custom-if
    39.     Cluster: local  Namespace: default
    40.     Type: webservice
    41.     Healthy Ready:1/1

    可以看到，第一个步骤 apply 成功后，会输出一个 outputs。第二个步骤 notification 中引用第一个步骤的 outputs 作为 inputs 并且进行判断，满足条件后成功发送通知。第三个步骤 notification-skip 判断第二个步骤是否为失败状态，条件不满足，这个步骤跳过。第四个步骤 判断第二个步骤是否成功，条件满足，该步骤成功执行。