This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Projects

A project is a collection of Plans. Projects enable you to easily group and identify plans which are logically related to each other. They are especially useful when generating reports across multiple Plans.

Note that creating a new project only requires defining the Project Name and Project Key, which is (optionally) done as part of the process of creating a new plan.

Plans

A Plan defines everything about your entire build process. Plans:

  • consist of one or more Jobs, which are organised into one or more Stages;
  • contains a single 'Default Job' in a single Stage, after creating a new Plan;
  • define default settings for what gets built by Jobs in the Plan (i.e. the 'default source repository');
  • define how the Plan's build is triggered;
  • who will be notified of the Job's build result;
  • define who has permission to view and perform various actions on the Plan and its Jobs.

Stages

Stages group (or 'map') Jobs to individual steps within an entire Plan's build process. For example, you may have an overall Plan build process that comprises a compilation step, followed by several test steps, followed by a deployment step. You can create separate Bamboo Stages to represent each of these steps. Stages have the following characteristics:

  • A Stage may contain one or more Jobs;
  • Depending on the availability of Bamboo agents, all Jobs in a Stage can be processed in parallel;
  • Stages are processed consecutively within a Plan, one at a time;
  • All Jobs in a Stage must be built and succeed before Bamboo builds any Jobs in the next Stage. If any Job fails in a Stage, no further Stages in the Plan will be processed and the Plan's build will fail.

Each new Plan created in Bamboo contains at least one Stage (to house the Default Job) and is known as the 'Default Stage'. Stages can only be configured by Bamboo administrators.

Jobs

A Job is a single build unit within a Plan. One or more Jobs can be organised into one or more Stages. 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 builder to use;
  • which agent capabilities are required for the build;
  • what artifacts the Job's build will produce;
  • what tests to run;
  • 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'.

Builds

A build is the execution of either a Plan or a Job. The execution of a Plan is referred to as a 'Plan build' and that of a Job is a 'Job build'.

Each plan's build results are stored in a subdirectory under your 'Build Directory' (see Locating Important Directories and Files).

Related Topics

Error rendering macro 'children'

null

  • No labels



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.