Overview
A run executable post stage action can be used to run an arbitrary command on the pulse™ master after a stage completes. The command can be passed arguments based on the build details using the variables described below. A possible use case for this post stage action is to trigger an agent reboot after a stage completes.
 | Note
Post stage actions execute on the pulse™ master, not on the agent that executed the stage. |
Configuration
command
The executable to run, either as an absolute path or the name of an executable in the PATH for the pulse™ master process.
This field is required.
examples
arguments
A space-separated list of arguments to pass to the command. To include spaces in an argument, you may escape them with a backslash (\), or surround the argument in double quotes ("..."). To include a literal backslash or double quote, escape with a backslash (e.g. \\, \"). The arguments may include any of the variables below:
| Variable |
Description |
| project |
The name of the project built. |
| number |
The build number or id for the build. |
| specification |
The name of the build specification built. |
| status |
The stage status as a lower case string. |
| revision |
The revision of the source checked out for the build. |
| build.dir |
Absolute path of the directory where the build is stored. |
| stage.agent |
Name of the agent the stage executed on. |
| stage.recipe |
Name of the recipe executed for the stage. |
| stage.status |
The stage status in lower case. |
| stage.dir |
Absolute path of the directory where the stage is stored. |
| command.<name>.status |
The command status in lower case. |
| command.<name>.dir |
Absolute path of the directory where the command is stored. |
Variables are refered to using the ${...} syntax, as used in pulse files. Variables for a specific command within the stage are prefixed with "command.<name>." where <name> is the name of the command (e.g. "command.build").
 | Build properties
Build properties defined on the build specification are also available. |
| Understanding the variables
To help illustrate the names and values of the available variables, an example set of variables will be displayed for the most recent successful build. |
Examples
Pass the directory containing files for an artifact named "reports" produced by command "test":
Pass any argument with spaces:
