The instructions on this page describe how to create a Job in a Stage. On this page:

Screenshot above: Create Job — Introductory Page

Create a New Job

When you create a new Job, you can define a single unit of execution within a Stage, including what gets built and what Builder to use.

Before you begin:

• You must have the 'Admin' or 'Create Plan' global permission to create a new Job.

To create a new Job:

1. Navigate to the Stages for the desired Plan, as described on Configuring a Stage.
2. Click the 'Create Job' link in the Stage that you want to create a new Job in. Choose 'Create a New Job' on the page that appears.
3. In the Job Details section, enter or select the relevant items for the following fields:
   • Stage — Select an existing Stage to which this Job will be added.
     If you have not added any further Jobs or Stages to this Plan since the Plan was created, there will only be one Stage available (with the default name of Default Stage).
   • Job Name — Enter a name for the new Job.
   • Job Key — Enter a unique key for the new Job.
   • Job Description — Enter a short sentence to describe this Job.
4. In the Source Repository section, specify the source repository configuration used for building this Job.
   For details, refer to the following source repository configuration procedures (from step 4), since many of these fields and options change depending on the 'Repository' you select:
   • CVS
   • Subversion
   • Perforce
   • Mercurial
     
5. In the Builder Configuration section, specify the configuration of the builder used for building this Job. The builder that you select will become one of this Job's requirements. For details please see Configuring a Job's Requirements.
   Refer to the following documentation on Bamboo's builders (from step 2) for details about these options, since many of these fields and options change depending on the 'Builder' you select:
   • Ant
   • Custom Command Builder
   • devenv.com
   • Grails
   • Maven
   • NAnt
   • PHPUnit
   • Script Builder
     
6. In the Enable this Plan/Job section, choose whether or not to enable this Job. Enabling the Job instructs Bamboo to execute builds of the Job whenever a Build of the Job's Plan is triggered. To enable this Job, select the 'Yes please!' check box.
7. Click the 'Create' button to create the Job and the Plan's Stages page will be displayed, indicating your new Job in its designated Stage.

If you wish to configure more Job options, please refer to Editing a Job.

Clone an Existing Job

When you clone an existing Job, you make a copy of that Job and its entire configuration.

Before you begin:

• You must have the 'Admin' or 'Create Plan' global permission to clone an existing Job.

To clone an existing Job:

1. Navigate to the Stages for the desired Plan, as described on Configuring a Stage.
2. Click the 'Create Job' link in the Stage that you want to create a new Job in. Choose 'Clone an Existing Job' on the page that appears.
3. In the 'Job to clone from' section and dropdown, enter or select the relevant items for the following fields:
   • 'Job to clone from' — Select the Plan containing the Job you wish to clone. Plans are grouped by Project in the list.
     Only Plans for which you have the 'Clone' and/or 'Admin' plan permission are shown.
   • 'Job to clone' — Select the Job you wish to clone from your selected Plan. Jobs are grouped by Stage in the list.
4. In the 'Job Details' section, enter or select the relevant items for the following fields:
   • Stage — Select an existing Stage to which this Job will be added.
     If you have not added any further Jobs or Stages to this Plan since the Plan was created, there will only be one Stage available (with the default name of Default Stage).
   • Job Name — Enter a name for the new Job.
   • Job Key — Enter a unique key for the new Job.
   • Job Description — Enter a short sentence to describe this Job.
5. In the Enable this Plan/Job section, choose whether or not to enable this Job. Enabling the Job instructs Bamboo to execute builds of the Job whenever a Build of the Job's Plan is triggered. To enable this Job, select the 'Yes please!' check box.
6. Click the 'Create' button to create the Job and the Plan's Stages page will be displayed, indicating your new Job in its designated Stage.

If you wish to configure more Job options, please refer to Editing a Job.