This page last changed on Mar 09, 2009 by alui.

Sometimes you may want to trigger a build when another plan's build has successfully completed. This ensures that changes to one plan's code do not break a dependent build (known as a 'child' build).

For example, there could be two plans in Bamboo:

  1. 'ACME-CORE' — which contains the core code for an application.
  2. 'ACME-PLUGIN' — which contains code for a plugin to the application.

In this scenario, ACME-PLUGIN is a child of ACME-CORE. Any changes to the ACME-CORE code should trigger a build of Acme-PLUGIN.

In turn, every time a build completes successfully for ACME-PLUGIN, you might want to then run builds for some additional plans (e.g 'ACME-FUNCTIONAL-TESTS' and 'ACME-UNIT-TESTS'). In this case, ACME-PLUGIN is a parent of ACME-FUNCTIONAL-TESTS and ACME-UNIT-TESTS, as well as being a child of ACME-CORE.

Please note, if the child build uses the same source as the parent build (e.g. the Subversion URL is the same), the child build will be forced to check out the same revision of source code as the parent build. This ensures that builds are consistent when triggering one build from another.

To trigger a build when another build finishes,

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in which you are interested.
  4. Click this icon:
  5. The plan's 'Configuration' tab will be displayed. Click the 'Dependencies' sub-tab.
  6. This will display lists of all plans in your Bamboo system (see screenshot below). All of these are possible 'Parent plans' and 'Child plans' for the current plan.
    • In the 'Parent plans' list, select any plans for which a successful build should trigger a build for the current plan.
    • In the 'Child plans' list, select any plans for which a build should be triggered when the current plan's build finishes successfully.
  7. Click the 'Save' button.
If you specify that a build should run when another build successfully finishes, you may want to prevent it from running at other times. You can achieve this by specifying 'manual builds only'.

See Triggering a Build Manually.


Screenshot: 'Plan Configuration--Dependencies'





Bamboo-dependencies.PNG (image/png)
config_16.gif (image/gif)
Document generated by Confluence on Mar 09, 2009 17:06