Releasing a new version of software usually involves a number of tasks, such as releasing the version in Jira Software, building and testing, merging code, creating tags, creating branches, labeling builds, etc. If you have connected Jira Software to Atlassian's Bamboo, you can trigger these tasks to run automatically at the release of a version in Jira Software.

When you release a Jira Software version, you will have the option of selecting a Bamboo plan and specifying which stages in the plan to run. Releasing the version will run the plan in Bamboo. If the Plan is successful, the version will be released on Jira Software. Otherwise, the version will not be released.

On this page:

Before you begin

  • Your Jira administrator must have integrated Jira Software with Bamboo. For instructions, see Configuring development tools.
  • Your Jira administrator must have installed the latest JIRA Bamboo app to use the release management feature. For instructions on how to install an app, see Managing apps.

  • You must be a project administrator for the project that the version is in. See Permissions overview for more information.

Running a Bamboo build when releasing a version

  1. Navigate to the project that your version is in.
  2. Click Releases.
  3. Click your desired version.
  4. On the version page, click the Release button.
  5. The release build dialog will be displayed.

  6. Enter the build details for the release:

    No Build
     Choose this option if you do not want to run a Bamboo build, i.e. you only want to release the version in Jira Software .

    New Build
    Choose this option, if you want to run a Bamboo build that has not been started:
    * Using Plan — You can select any plan in the linked Bamboo instance that you have permission to view (unless your administrator has configured basic HTTP authentication).
    * Stages — You can select the stages that you want to run for this release. Note, you cannot skip stages.
    * Build Variables — You can override any global variables or plan variables with your own parameters. See Running a plan build manually in Bamboo.

    Existing Build
    Choose this option, if you want to run a Bamboo build that is in progress and has been paused at an optional stage:
    * Using Plan — You can select any plan in the linked Bamboo instance that you have permission to view (unless your administrator has configured basic HTTP authentication).
    * Stages — You can select the stages that you want to run for this release. Note, you cannot re-run stages that have been completed nor skip stages.
    * Build Variables — You can override any global variables  or plan variables with your own parameters. See Running a plan build manually in Bamboo.

  7. Click Release. The Bamboo build will run. If it is successful, the version will be released. If not, you can choose to run it again, or select a different plan.

Next steps

(info) Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.

Read the following related topics:

  • No labels