This page last changed on Dec 12, 2007 by rosie@atlassian.com.
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.

Before you begin
You need to configure Bamboo's SMTP email and/or instant messaging capabilities before Bamboo can send notifications.


To enable notifications for a plan,

If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Build Notifications' sub-tab.
  5. 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.
  6. Click the 'Add' button.
  7. Repeat steps 5 and 6 until you have added all the Notification Triggers that you wish to enable for this plan.
  8. 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 1.2.7 Specifying a Plan's Post Actions or click the 'Summarise' button and go to 1.2.9 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' 


Document generated by Confluence on Apr 14, 2008 01:39