Overview
Post stage actions are actions executed on the pulse™ master server after a build stage completes. They may be used to perform custom post-processing required by the build stage. Examples include:
- Tagging the built source with a stage-specific tag.
- Shutting down or rebooting the agent used for the stage to intialise it for other stages or builds.
Note that you can also execute actions after the entire build is complete using post build actions.
Adding Post Stage Actions
Post stage actions can be added to a build stage by clicking the "add new post stage action" link at the bottom of the "post stage actions" table for the stage. This link launches the post stage action wizard, which will prompt you for common action details and an action type. Depending on the type selected you may be asked to provide further details. The common fields are described below.
name
A descriptive name for the action.
Examples
type
The type of action to perform, one of:
| Type |
Description |
| apply tag |
Applies a tag or label to the built revision in the project's SCM. |
| run executable |
Runs an arbitrary command when the stage completes. |
Refer to the page of the chosen type when completing subsequent steps of the wizard.
restrict to states
Shows a list of completed build states to restrict the action to. If no states are selected, the action will be run regardless of the stage result. If one or more states are selected, the action will only be run if the stage completes in one of the selected states.
Examples
To apply a tag to the built revision only if the stage succeeds, then select "success". This tag will then indicate the last known successful revision for that stage.
fail build on error
If checked, a failure to execute the action will mark the stage as a failure. Typically the post stage action is considered outside the scope of the stage result, so you should leave this option unchecked. However, if the action must succeed for the stage to pass, you may select this option.
Managing Post Stage Actions
Existing post stage actions may be managed via the "post stage actions" table for a stage. To edit an existing action, clik the "edit" link in the corresponding row of the table. Refer to the descriptions above and the page for the specific action type for field details. To delete an action, click the "delete" link in the corresponding row of the table.
