Defining build triggers

Triggers can determine when builds occur. There are several types of triggers.

Create a build process to which you want to add a trigger.

Builds can be triggered by repository events, such as source code changes; triggered on a schedule; or triggered by post-processing events, such as completing builds in related projects.

  1. On the left navigational panel, click Projects, and then use the expand icon associated with a project to display the project's build processes.
  2. Select a build process.
  3. Define a trigger by completing these steps:
    1. Click Triggers, and then click New Trigger.
    2. Select a trigger type from the Type list, and click Select.
      The trigger types are described in the following table.
      Table 1. Trigger types
      Trigger type Description
      Scheduled Trigger Scheduled triggers run on their own timers that poll the SCM tools for changes. When changes are detected, the build starts at the scheduled time. Scheduled triggers can be configured to force builds regardless of whether source changes occurred.
      Repository Trigger Repository triggers initiate builds whenever source code changes occur in the repository.
      Post-Process Trigger Post-processing triggers listen for post-processing events. When an event is detected, it can trigger other events. See Creating post-processing scripts.
    3. Type a name for the trigger in the Name list.
    4. Optional: If you selected Scheduled Trigger, select a schedule from the Schedule list.
      For information about schedules, see Creating schedules.
    5. Select Force to force builds when triggers occur.
      If Force is selected, builds are triggered even if source changes are not detected.
    6. Select a priority option from the Priority list.
      Priority options determine when queued build requests run. Requests with a High priority run before requests with Normal or Low priorities. Requests with Normal priority run before requests with Low priority. Normal is the default option.
    7. Selected Enabled to make the trigger active.
    8. Optional: If you selected Post-Processing Trigger, select a process from the Secondary Process list.
      For information about schedules, see Creating schedules.
    9. Click Save.