Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

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

When you release a JIRA 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. Otherwise, the version will not be released.

On this page:

Procedure

Before you begin:

  • Your JIRA administrator must have integrated JIRA with Bamboo (i.e. set up a two-way application link between JIRA and Bamboo). For instructions on how to integrate JIRA with Bamboo, see Integrating JIRA with Bamboo.
  • Your JIRA administrator must have installed the latest JIRA Bamboo plugin to use the release management feature. For instructions on how to install a plugin, see Managing JIRA's Plugins.

To run a Bamboo build when releasing a version:

  1. Log in to JIRA as a project administrator. (A project administrator is someone who has the project-specific permission 'Administer Project', but not necessarily the global permission 'JIRA Administrators'.)
  2. Navigate to 'Projects' menu > the desired project > the desired version > 'Release' tab.
    If you are a JIRA administrator, ensure that you are not in 'Administration' mode, otherwise you will not see the controls described above.
  3. Release the version. The release build dialogue will be displayed (see screenshot below).
  4. 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.

    'Release new Build'

    Choose this option, if you want to run a Bamboo build that has not been started:
    * 'Using Plan' — You will be able to select any Plan in the linked Bamboo instance that you have permission to view (unless your administrator has configured basic HTTP authentication).
    * 'Stages' — You will be able to select the Stages that you want to run for this release. Note, you cannot skip Stages.
    * 'Build Variables' — You can choose to override build variables (similar to Triggering a Plan Build Manually in Bamboo).

    'Release 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 will be able to select any Plan in the linked Bamboo instance that you have permission to view (unless your administrator has configured basic HTTP authentication).
    * 'Stages' — You will be able to 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 choose to override build variables (similar to Triggering a Plan Build Manually in Bamboo).

  5. Click the 'Release' button. The Bamboo build will run. If it is successful, the JIRA version will be released. If not, you can choose to run it again or select a different Plan.

Screenshot above: Selecting the build for a release

Notes

Related Topics

Integrating JIRA with Bamboo
Managing JIRA's Plugins

  • No labels