Bamboo 3.4 : Creating a Job

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

A Job is a single build unit within a Plan. One or more Jobs can be organised into one or more Stages. A Job is made up of one or more Tasks. A Job defines:

  • what gets built (i.e. the source code repository) — this can be a custom, Job-specific source repository or the 'default source repository' of the Plan that contains this Job;
  • which agent capabilities are required for the build (based on Job-specific requirements and requirements of the Job's Tasks);
  • what Tasks make up the Job and the order in which they are executed;
  • what artifacts the Job's build will produce;
  • any labels with which the build result or build artifacts will be tagged;

Each new Plan created in Bamboo contains at least one Job known as the 'Default Job'.

Projects and plans can only be configured by Bamboo administrators (see Creating a Plan).

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:

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 (see screenshot below).
  3. In the Job Detailssection, enter or select the relevant items for the following fields:
    • Stage — Select an existing Stage to which this Job will be added.
      (info) 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 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.
  5. 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, such as configuring Repository Checkouts or Tasks, please refer to Editing a Job.


Screenshot above: Creating a new 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:

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 (see screenshot below).
  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.
      (info) 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.
      (info) 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.


Screenshot above: Cloning an existing Job

Notes

Related Topics

Configuring a Plan
Configuring a Stage
Editing a Job
Disabling or Deleting a Job