Skip to main content Skip to docs navigation
Check
View on GitHub

Action Sets (Workflow)

Create executable action-sets (a.k.a workflows) for a menu command.

Workflows are defined under the workflows YAML attribute of the instructions.yaml file.

instructions:
  workflows:
    - id: "workflow-id"
      displayName: "Selection name"
      title: "Shorter information"
      description: "Longer information"
      tolerateFailures: true
      actionIds:
        - action-id-1
        - action-id-2
Task Description Type Default value
instructions.workflows[].id Identifier, by default this is the text used as the interactive selector string Required
instructions.workflows[].displayName Alternative name to use for displaying the workflow on the interactive selector (Optional) string -
instructions.workflows[].title Short title about what this workflow is all about, appended to the interactive selector string -
instructions.workflows[].description Longer info about the workflow responsibilities, shown on the information section - off the interactive selector string -
instructions.workflows[].tolerateFailures Continue to the next action upon failure or fail the entire workflow bool False
instructions.workflows[].context Context scope of the workflow
Available values:
  • application - prints basic prompt message
  • kubernetes - prints k8s current context and check if kubectl exists
string application
instructions.workflows[].actionIds List of ordered action ids to get executed upon workflow run string[] -
globals.context Same as action context, but applied to all actions in the file string -

Example:

instructions:
  actions:
    - id: install-jenkins-master
        ...

    - id: install-jenkins-agents
        ...

  workflows:
    - id: provision-jenkins-server-agents
      displayName: "Jenkins: Provision Server/Agents"
      title: "No-Op action, used as an example"
      description: "Provision a Jenkins server and x3 agents"
      tolerateFailures: true
      actionIds:
        - install-jenkins-master
        - install-jenkins-agents
In the following example, backoffice is the name of the folder containing the instructions.yaml file.