Overview
A project trigger is used to queue a build for a project when a particular event occurs. This event may be the passing of a specific length of time (e.g. trigger every 15 minutes), detection of a change to the projects source code, or some other event. Triggers tie together the event to fire on with the build specification to execute when the event occurs.
Each project can have multiple triggers for different events and/or build specifications. The triggers for a project may be seen in the "triggers" table of the "configuration" tab for that project.
Default Trigger
When a project is created, a trigger is automatically added to the project to monitor the project's SCM and trigger a build of the default build specification when a change to the source code is detected. If you do not want to monitor the project's SCM, or want to trigger a different specification, you should modify this default trigger.
Creating Triggers
You can add a new trigger to a project by clicking the "add new trigger" link at the bottom of the "triggers" table on the project's "configuration" tab. This link will take you to the "add trigger wizard". At the first step of the wizard you configure common trigger details and choose a trigger type. The second step is type-dependent; refer to the page for the specific trigger type for configuration details.
name
A descriptive name for the trigger, used when referring to the trigger in the web interface.
Examples
trigger type
The type of trigger to add, one of:
| Type |
Description |
| build completed trigger |
A trigger that fires when a build of a selected project completes. |
| cron trigger |
A trigger that fires on a schedule defined with a cron-like string. |
| monitor scm trigger |
A trigger that monitors the project's SCM and fires whenever a change to the project's source code is detected. |
build specification
The name of the build specification to enqueue a build request for when this trigger fires.
Disabling Triggers
If you wish to suspend operation of a trigger temporarily, it is simplest to disable the trigger. This can be done using the "disable" link in the corresponding row of the "triggers" table. To reactivate the trigger, use the "enable" link that replaces the "disable" link while a trigger is disabled.
Managing Triggers
Existing triggers may be edited and/or deleted using the "edit" and "delete" links in the corresponding row of the "triggers" table on the project's "configuration" tab. When editing a trigger, you will be presented with a form containing both the fields described above and the fields for the specific type of trigger (refer to the trigger type's page for details).
