All Versions
Bamboo 5.13Bamboo 5.7.x
Bamboo 5.6.x
More...
A label is a convenient way to tag and group build results that are logically related to each other. Labels can also be used to define RSS feeds and to control build expiry.
Labels can be applied to build results automatically, by specifying the label(s) in a build plan (note that only Bamboo administrators can do this). Labels can also be applied ad hoc to build results by Bamboo users.
To specify labels for a plan's build results,
If you are creating a new plan, start at step 5.
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:
- The 'Configuration' tab will be displayed. Click the 'Post Actions' sub-tab.
- The 'Post Actions' tab will be displayed (see screenshot below).
- In the 'Regex Pattern' field, you can either:
- Specify a regular expression on which to match the log files. Labels will be applied to the build if the regular expression finds a match (see the examples below).
For more information about regular expressions, please visit http://java.sun.com/j2se/1.4.2/docs/api/java/util/regex/Pattern.html#sum. - Leave this field blank to label every build.
- Specify a regular expression on which to match the log files. Labels will be applied to the build if the regular expression finds a match (see the examples below).
- In the 'Labels' field, type the word (or multiple words, separated by commas and/or spaces) with which the plan's build results are to be labelled.
- Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, either click the 'Next' button and go to Specifying a Plan's Permissions.
Screenshot: 'Post Actions'
Regex example:
'There are \d+ results'
In the above regex, '\d+' represents any number with one or more digits. ('\d' means 'any digit', and '+' means 'one or more times'. When combined, they mean 'any sequence of one or more digits'.)
Therefore, positive matches would include:
- 'There are 0 results'
- 'There are 123 results'
Regex example with multiple labels:
You can use "capturing groups" with Bamboo 1.2.1 or later to create different labels for different purposes.
For example,
- Enter the following into the 'Regex Pattern' field:
(PERFORMANCE_IMPROVED|PERFORMANCE_DETERIORATED)
- Enter the following into the 'Labels' field:
\1
These settings will label your builds with PERFORMANCE_IMPROVED if "PERFORMANCE_IMPROVED" appears in the build log, and PERFORMANCE_DETERIORATED if "PERFORMANCE_DETERIORATED" appears in the build log. If both strings appear in a log, then both labels are applied to the build.
Overview
Content Tools
Apps
Log a request with our support team.
Raise an issue for our developers.
See answers from the community.
Tweet, blog and update our documentation.
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.