This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

Triggering a build manually or by build dependencies allows you to ensure that builds are only triggered manually or by parent builds of dependent builds. You can also run override any Plan variables with your own parameters when triggering a build manually. This is referred to as running a 'parameterised Plan build'.

If you want to trigger builds automatically rather than manually, you can trigger builds based on code changes or based on a schedule.

On this page:

Starting a Plan Build Manually

To start a Plan build manually:

  1. Locate the relevant Plan on the Dashboard.
  2. Click the 'Run' icon .

Starting a Parameterised Plan Build

If you trigger a Plan build manually, you can override any Plan variables by substituting in your own parameters.

始める前に

  • You cannot run a parameterised Plan build if it is triggered automatically.
  • The Plan must have Plan variables defined to run a parameterised Plan build.

To start a parameterised Plan build:

  1. Navigate to the Plan Summary (not Plan configuration) for the desired Plan.
  2. Click the 'Actions' menu, then click 'Run Parameterised Plan'.
  3. In the 'Replace Build Variables' popup window, change the value for the Plan variables as desired and click 'Run'

Screenshot above: Overriding Plan Variables for a Parameterised Plan Build

Configuring a Plan's Build to be Triggered Only Manually or via a Dependency

You can specify that a plan should only ever be built manually or triggered by other builds. This is useful for:

  • Broken builds — If a build is broken, you may want to temporarily specify 'Manual & dependent builds only'. This means that a failing build will not be triggered frequently and hence will not take up time and processing power when other builds could be running.
  • Dependent builds

    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 & dependent builds only'.

To allow a Plan's build to be triggered only manually or via a dependency:

  1. Navigate to the repository settings for desired Plan, as described on Specifying the Source Repository for a Plan.
  2. In the 'Build Strategy' field, select 'Manual & dependent builds only' (see screenshot below).
  3. 保存」ボタンをクリックします。

Screenshot above: Plan Configuration — Build Strategy: Manual builds only

注意

関連トピック

Stopping an Active Job Build
Defining Plan Variables