With a vRealize Orchestrator task, you can configure a vRealize Orchestrator to be triggered as part of the release pipeline process.

Prerequisites

Verify that you created a workflow and tagged it with the vRCS_CUSTOM keyword in the vRealize Orchestrator Workflow Designer.

Procedure

  1. Click the Code Stream tab.
  2. Select an existing pipeline to configure from the Pipeline tab.
  3. Select Edit > Stages.
  4. Select Add Task.
  5. Select vRealize Orchestrator Workflow from the Provider drop-down menu.
  6. Enter a name for the custom task and click OK.
  7. Select the new task from the stage column.
  8. Confirm to save the pipeline.
  9. Select an Execute Task for the release pipeline.

    Option

    Description

    Always

    Runs the release pipeline task without conditions.

    On Condition(s)

    Runs the release pipeline task only if the defined condition is evaluated as true. If the condition is false, the task is skipped.

    A boolean expression using the following operands and operators is supported.

    • Pipeline variables such as, ${pipeline.variableName}. Curly brackets are reserved for specifying pipeline variables.

    • Task output variables such as, ${Stage1.task1.machines[0].value.hostIp[0]}

    • Default pipeline binding variables such as, ${releasePipelineName}

    • Case insensitive Boolean values such as, true, false, 'true', 'false'

    • Integer or decimal values without quotes

    • String values used with single or double quotes such as, "test", 'test'

    • String and Numeric types of values such as, == Equals and != Not Equals

    • Relational operators such as, > , >=, <, and <=

    • Boolean logic such as, && and ||

    • Arithmetic operators such as, +, -, *, and /

    • Nested expressions using round brackets

    • Strings with literal value ABCD is evaluated as false and the task is skipped.

    Unary operators are not supported.

    A sample condition, ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39

  10. (Optional) : Select the Continue Pipeline execution even if this task fails option .

    This option allows the release pipeline to bypass the failed task and continue with the execution process.

  11. Select the workflow name from the drop-down menu.
  12. Enter the input parameters.

    For example, enter vsphere.local\administrators for the Task Group DN Name and enter the task details.

  13. Click Save.

Task Output Format for a vRealize Orchestrator Workflow Task

The following task output format is an example for a custom workflow task.

[{
                "name": "result",
                "type": "STRING",
                "description": "Result of workflow run.",
                "value": ""
},
{
                "name": "message",
                "type": "STRING",
                "description": "Message",
                "value": ""
}]