This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

When creating a new plan, the first step is to specify the plan's details and the project to which it will belong.

A project is a collection of plans.

A project enables easy identification of plans that are logically related to each other, which is useful for instance when generating reports across multiple plans.

Each project has a Name (e.g. "CRM System") and a Key (e.g. "CRM"). The Project Key is prefixed to the relevant Plan Keys, e.g. the "CRM" project could have plans "CRM-TRUNK" and "CRM-BRANCH".



To specify a plan's details,

  1. Project — When you create a new plan, you can either add it to an existing project or create a new project. Either:
    • Select the appropriate project from the drop-down list;
      or:
    • Select 'New Project' and complete the following two fields:
      1. Project Name — Type a descriptive name (e.g. 'Issue Tracking Application') that will identify your project on the Dashboard and in reports
      2. Project Key--- Type a logical contraction of the Project Name (e.g. 'ITA'). The Project Key will be included in the plan's Build Results keys (e.g. 'ITA-MAIN-179'), so you may want to make it no longer than 3 or 4 characters. The Project Key must be unique within your Bamboo system.
  2. Build Plan Name--- Type a name that will identify the plan within its project (e.g. 'Main Build', 'Branch', 'Unit Tests', 'Acceptance Tests'). Note that the Build Plan Name, which is displayed throughout Bamboo, is always accompanied by its Project Name.
  3. Build Plan Key — Type a logical contraction of the Build Plan Name. The Build Plan Key (e.g. 'MAIN') will be included in the plan's Build Results keys (e.g. 'ITA-MAIN-179'), so you may want to make it no longer than 3 or 4 characters.
    (info) Note that the Build Plan Key only has to be unique within the project, that is, you could have a 'MAIN' plan in lots of different projects.
  4. Click the 'Next' button to go to Specifying a Plan's Source Repository.


Screenshot: 'Plan Details'