Build Event Handlers are tasks which execute on the server (as opposed to Actions which run on the agents). They can be configured to respond to one or more of the following build events.
Build event | When triggered |
---|---|
On Build Created | When a new build is initialised, after checking repositories, associating changesets and creating workspace folder, but before stages are initialised and build is queued. |
On Before Build Queued | Before a new build is added to the build queue, after initialising build and stages, but before configuration conditions are checked. |
On Before Build Start | Before a build is started, once conditions are checked and build is removed from queue . |
On After Build Started | After build is started, build version allocated and repository cache is updated to the latest revision. |
On Before Stage Start | Before a specified stage is started, after license has been allocated and agent reserved. |
On Sending Stage To Agent | Before stage is sent to an agent for execution, after checking agent is online and setting up build log. |
On Stage Completed | Once stage has completed and has not been stopped, after updating any unit test metrics. |
On Build Pending Promotion | When build is paused pending promotion to the next stage |
On Before Build Continue | When build is paused pending promotion to the next stage |
On After Build Continued | Before a build is continues after promotion, once conditions are checked and build is removed from queue. |
On Build Stopping | When build stop has been requested either manually by a user or by a Stop action. |
On Build Completed | When build has completed, either successfully or on failure, after build statistics are updated and workspace cleaned up. |
...