Errands

Errands are an Escape mechanism that make it easy to run operational and publication tasks against deployed packages. They can be used to implement backup procedures, user management, scalability controls, binary publications, etc. Errands are a good idea whenever a task needs to be aware of Environments.

You can inspect and run Errands using the escape errands command.

Escape Plan

Errands are configured in the Escape Plan under the errands field.

FieldTypeDescription
namestringThe name of the errand. This field is required.
descriptionstringAn optional description of the errand.
scriptstringThe script or command performing the errand (deprecated, use ‘run’ instead).
The script has access to the deployment inputs and outputs as enviroment variables. For example: an input with "id": "input_variable" will be accessible as INPUT_input_variable; and an output with "id": "output_variable" as OUTPUT_output_variable.
exec_stageExecStageThe script or command performing the errand.
The command has access to the deployment inputs and outputs as enviroment variables. For example: an input with "id": "input_variable" will be accessible as INPUT_input_variable; and an output with "id": "output_variable" as OUTPUT_output_variable.
inputs[variables.Variable]A list of Variables. The values will be made available to the script (along with the regular deployment inputs and outputs) as environment variables. For example: a variable with "id": "input_variable" will be accessible as environment variable INPUT_input_variable