Using stages in a plan

Stages group (or 'map') jobs to individual steps within a 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.

A stage:

  • Has a single job, by default, but can be used to group multiple jobs.
  • Processes its jobs in parallel, on multiple agents (where available).
  • Must successfully complete all its jobs before the next stage in the plan can be processed.
  • May produce artifacts that can be made available for use by a subsequent stage.

Each new plan created in Bamboo contains at least one stage (for the default job) and is known as the 'Default Stage'. Stages can only be configured by Bamboo administrators.

On this page:

About manual stages

Any stage in a plan can be configured to be a manual stage. If you run a plan with manual stages, Bamboo will pause the execution of the plan every time it reaches a manual stage. The plan build will only continue once a user has manually triggered the stage. Please note:

  • A manual stage can only be triggered if the previous stage has completed successfully.
  • Manual stages must be be executed in the order that they are configured in the plan. You cannot skip a manual stage.
  • Manual stages will be displayed in the Plan Navigator with either this icon (not due to be triggered) or this icon (pending execution).
  • You need 'Build' permission on the plan to run a manual stage.

Navigate to the stages for a plan

To navigate to the stages for a plan:

  1. Choose Build > All build plans from the Bamboo header, then click the name of the plan you want to edit.
  2. Choose Actions > Configure Plan.
  3. Click the Stages tab.

Create a stage

  1. Navigate to the stages for the plan, as described above.
  2. Click Create Stage, at the right. 
  3. Complete the form and click Create. For information about manual stages, see About manual stages above.
  4. (optional)You may want to do one or more of the following with your new stage:
    • Order your new stage in the list of stages, by dragging and dropping it.
    • Add a new job to your stage.
    • Move a job from another stage to your new stage by dragging and dropping the job.

Note that you may break artifact dependencies by moving stages, or by moving jobs between stages. Bamboo will warn you, if a dependency will be broken by moving a stage or a job.

Edit a stage

  1. Navigate to the stages for the plan, as described above.
  2. Edit the stage as required:
    • To edit the name and description of the stage or configure whether it is a manual stage, click the cog icon and choose Configure stage.
    • To move the stage, drag and drop the stage to the desired place in the plan.

Note that you may break artifact dependencies by moving stages. Bamboo will warn you if a dependency will be broken by moving a stage.

Delete a stage

Before you begin, please understand that:

  • Deleting a stage will delete all job configurations, artifacts, logs and results related to the stage. These cannot be recovered after the stage is deleted.
  • You may break artifact dependencies by deleting a stage.

To delete a stage:

  1. Navigate to the stages for the plan, as described above.
  2. Click the cog icon for the relevant stage and choose Delete stage.
  3. Click Confirm to delete the stage. Note that a deleted stage cannot be recovered.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport