Variables

Variables can be defined on any configured node. They:

  • Can replace values in the configuration iteslf.
  • Are made available within an artifact to any tasks.

Config Replacement

You can use variables to replace any argument value in the configuration for example:

{
    "vars": {
        "description": "Cool Project"
    },
    "nodes": {
        "hello": {
            "type": "script",
            "args": {
                "script": "echo This is a %description%"
            }
        }
    }
}

The following rules apply:

  • string values can be replaced within a string as above.
  • array values will replace the _entire_ value. Any surrounding text or subsequent tokens will not be taken into account.

Artifacts

The Variables artifact is made available for all task handlers and contains the aggregated variables for the ancestors of the task’s originating node.