When creating a new plan, the first step is to specify the plan's details and the project to which it will belong.
To specify a plan's details,
- 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:
- Project Name — Type a descriptive name (e.g. 'Issue Tracking Application') that will identify your project on the Dashboard and in reports.
- 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.
- 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.
- 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.
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.
- Click the 'Next' button to go to Specifying a Plan's Source Repository.
Screenshot: 'Plan Details'
