Bamboo 3.4 : Configuring Automatic Labelling of Job Build Results

For each Job of a Plan, you can (as an option) specify a 'post action' label that can be applied to the Job's build results automatically after (or 'post') each build of that Job.

Automatic labelling of Job builds is a 'post action' feature (i.e. performed at the completion of Job builds), which is built into Bamboo itself. There are a number of third-party plugin modules available that can provide additional post actions (e.g. the Pre-Post Build Command plugin). You can also write your own plugins to provide additional post actions for a Job. See the Bamboo Plugin Guide​ for further details.

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.

Specifying Labels for a Job's Build Results

To specify labels for a Job's build results:

  1. Navigate to a Job's configuration pages, as described on Editing a Job.
  2. Click the 'Post Actions' sub-tab (see screenshot below).
  3. In the 'Regex Pattern' field, you can either:
    • Specify a regular expression to match content in the log files of this Job's builds. Labels will be applied to a build of this Job if this regular expression matches content in the build's log files (see the examples below).
      (info) For more information about regular expressions, please refer to the Java documentation on regular expression constructs.
    • Leave this field blank to label every build of this Job.
  4. 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.
  5. Click the 'Save' button to save your changes.



Screenshot: 'Post Actions'

Regex Examples:

A simple 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'

A 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, the following 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.

  • Enter the following into the 'Regex Pattern' field:
    (PERFORMANCE_IMPROVED|PERFORMANCE_DETERIORATED)
  • Enter the following into the 'Labels' field:
    \1

Notes

Related Topics

Editing a Job