How to perform a Bamboo build based on a Git tag

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Bamboo presents two different options for performing a build based on a Git tag. This knowledge-base article describes each method and how to perform or configure them.

Environment

  • Run customized build using a tag: Any version of Bamboo

  • Tag triggering: Available in Bamboo 7.2 and above

Solution

One off manual build

Bamboo will allow you to specify a tag or revision when performing the Run Customised function which is a manual build that can be performed at any time through the UI.

To perform a Run Customised  build:

  1. From any UI screen where the Run  dropdown is present for a particular plan, e.g. when viewing or editing a plan:

  2. Run >> Run Customised

  3. Enter the tag name in the Revision  field

More detail is contained in the below documentation:

Automatic builds based on tag being pushed

There is a feature introduced in Bamboo 7.2 called Tag Triggering. This feature will allow you to trigger a build automatically when tags (or certain tags) are pushed to your Git repository. You can filter the triggering using a Regular Expression to match only certain tag patterns too.

To add a tag trigger to a plan

  1. Visit Plan Configuration >> Triggers

  2. Add a trigger of type Tag Trigger

More detail is contained in the below documentation:

Updated on March 13, 2025

Still need help?

The Atlassian Community is here for you.