This page last changed on Oct 16, 2008 by alui.
You can specify which people will receive notifications about build results for a particular plan, and under what circumstances (known as 'Notification Triggers'), i.e.:
Notification Trigger |
Description |
'All Completed Builds' |
Bamboo will send a notification whenever a build finishes for this plan, regardless of the build result. This trigger is recommended for any plans for which it is critical that people are always informed about the latest build activity.
Many organisations start with this trigger, then change it later as they get more confidence in the continuous build process. |
'Failed Builds And First Successful' |
This trigger is generally suitable for the majority of plans. Bamboo will send a notification whenever:
- a build fails for this plan.
- the plan is 'fixed' (that is, the plan's latest build is successful and the previous build failed).
|
'After X Failed Builds' |
This trigger enables you to specify the 'Number Of Failed Builds' after which Bamboo will send a notification. This is a useful way of limiting the number of notifications, if you are concerned about people receiving too many. |
For each plan, you can specify different recipients for each Notification Trigger. Note also that recipients need not be people with Bamboo user accounts.
To enable notifications for a plan,
If you are creating a new plan, start at step 5.
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Build Notifications' sub-tab.
- A list of 'Notification Triggers' will be displayed (see screenshot below). Select the 'Notification Trigger' you wish to enable, then specify any or all of the following recipients:
- 'Roles' — Select from the following:
- 'Committer' —
A committer is the Bamboo user(s) who committed code to a particular build (i.e. someone who committed code after the previous build was checked out by Bamboo).
- 'Watcher' —
A plan's watchers are the Bamboo users who have marked this plan as one of their favourites.
- 'Groups' — Type the names of the appropriate Bamboo group(s), separated by commas.
- 'Users' — Type the usernames of the appropriate Bamboo users, separated by commas; or click the following icon to select from a list of users:

- 'Email Addresses' — This is useful if you need to send email notifications to people who are not Bamboo users. Type the appropriate email addresses, separated by commas.
- 'Instant Messaging Addresses' — This is useful if you need to send IM notifications to people who are not Bamboo users. Type the appropriate IM addresses, separated by commas. Note that if you specify a broadcast address (eg. 'project-x@broadcast.chat.mycompany.com'), Bamboo will not know the context of related IM responses.
- Click the 'Add' button.
- Repeat steps 5 and 6 until you have added all the Notification Triggers that you wish to enable for this plan.
- Click the 'Done' button if you are editing an existing plan; or if you are creating a new plan, either click the 'Next' button and go to Specifying a Plan's Post Actions or click the 'Summarise' button and go to Completing and Enabling a New Plan (hidden).
Each Bamboo user can choose whether to receive their notifications via email, IM, both or neither.
Screenshot: 'Build Notifications'

|