This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

You can configure Bamboo to poll the repository for source code changes, either:

  • periodically (e.g. every 180 seconds), or
  • based on a schedule (e.g. the second Sunday of every month at 5:00 am).

If Bamboo detects a change, a build of your plan is triggered.

On this page:

Periodic polling for repository changes


To trigger a plan's build periodically:

  1. Navigate to the repository settings for desired plan, as described on Specifying the Source Repository for a Plan.
  2. From the Build Strategy list, choose Polling the Repository for changes.
  3. Choose Periodically from the Polling Strategy options.
  4. Use Polling Frequency to specify how often (in seconds) Bamboo should check the repository for changes.
  5. Click Save.

Screenshot: Polling the repository for changes


Scheduled polling for repository changes

You can use the Schedule Editor to set up a polling schedule for your repository. Note, this is a schedule for polling your repository: a plan build will be be triggered only if there are source code changes. See also how to schedule for directly triggering plans.

The schedule can be daily (times per day), weekly (days per week), monthly (days per month) or based on a Cron expression.


To trigger a plan's build based on a schedule:

  1. Navigate to the repository settings for desired Plan, as described on Specifying the Source Repository for a Plan.
  2. From the Build Strategy list, choose Polling the Repository for changes.
  3. Choose Scheduled from the Polling Strategy options. The Schedule field will display the last configured schedule, e.g. 'Daily at 5:00 am'.
  4. Click the edit icon () next to the Schedule field to display the Schedule Editor.
  5. Use the Schedule Editor to set up the polling schedule.
    • Note that a cron expression consists of 6 mandatory and one optional field. The fields in sequential order are: seconds, minutes, hours, day-of-month, month, day-of-week and (optional) year. For example, 0 0 1 ? * 1#2. For information on Cron expressions, see this FAQ: How do I construct a cron expression in Bamboo
  6. Click Save.

Screenshots: Scheduling polling for changes

 

1. Daily
2. Week
3. Month
4. Cron

Notes

Related Topics

Triggering a Plan Build when Code is Updated
Triggering a Plan Build Based on a Schedule



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.