Develocity Bamboo plugin

Migration Notice

As of version 1.3.0, the plugin contains the renaming from Gradle Enterprise to Develocity. However, it was still available under the same Maven coordinates. Version 2.0.0 updates that to com.gradle.develocity:develocity-bamboo-plugin. It also contains several internal changes that make it backward incompatible with 1.3.0.

Additionally, starting from 2.0.0, the plugin is no longer available via Atlassian Marketplace due to Atlassian’s migration to the Cloud.

To upgrade from 1.3.0 to 2.0.0 follow these steps:

1. Take note of the current configuration settings, as after the upgrade, the plugin will need to be configured again.

2. Uninstall the app via the Manage Apps section on the Bamboo Administration page.

3. Install the new version as mentioned here.

4. Configure the plugin again using the configuration settings from step #1.

Important

Develocity 2024.1 or above is required starting from version 2.2.0 and above. See Short-lived access tokens for more infos.

Overview

This plugin integrates with Develocity for Gradle and Maven builds run via Bamboo. Build scans are available as a free service on scans.gradle.com and commercially via Develocity.

For each Gradle and Maven build that is run from Bamboo, this plugin exposes the links to the created build scans in the Bamboo UI. The plugin can also be configured to ad-hoc connect Gradle and Maven builds to an existing Develocity instance such that a Build Scan is published each time a build is run from Bamboo.

Installation

The plugin can be manually installed as mentioned in Uploading your own plugin section. The released JARs can be found at Releases.

Once the plugin is installed, the Bamboo Administration page will have a new section available under the “Managed Apps” group named Develocity integration.

When you select the said section, the following configuration will be available

Configuration

Using Bamboo Shared Credential for Develocity server authentication

In order to specify an access key for Develocity server, you would need to create a Shared Credentials in Bamboo and reference the name of that credential in the “Shared credential name” field of the Develocity integration page. To create a Bamboo Shared Credentials, you’d need to navigate to the Bamboo Administration page and select the “Shared credentials” section.

When clicking “Add new credentials”, select the “Username and password” option from the dropdown.

Fill the form as following:

• Credential name - this is the name of the credential that you’ll be referencing in the “Shared credential name” field of the Develocity integration page.

• Username - you can specify any username value here, as it will not be used by the plugin

• Password - this should be the value of the access key which is used during the build execution to get a short-lived access token from the Develocity server. It has a format of a key value pair (e.g. host=value)

Short-lived access tokens

Develocity access keys are long-lived, creating risks if they are leaked. To avoid this, users can use short-lived access tokens to authenticate with Develocity. Access tokens can be used wherever an access key would be used. Access tokens are only valid for the Develocity instance that created them. If a short-lived token fails to be retrieved (for example, if the Develocity server version is lower than 2024.1), no access key will be set. In that case, Develocity authenticated operations like build cache read/write and build scan publication will fail without failing the build. For more information on short-lived tokens, see Develocity API documentation.

Gradle Auto-instrumentation

To enable build scan publishing for Gradle builds, the configuration would look something like presented below (using https://develocity.mycompany.com as an example of Develocity server URL and Develocity Access Key as a name of a Shared Credential in Bamboo). You’d need to specify your Develocity server URL, select “Allow untrusted server” if applicable, specify the desired Develocity Gradle plugin version and, if required, specify the name of the Bamboo shared credential that holds the access key for authenticating with the Develocity server. You can also override the Gradle plugin repository URL if you aren’t able to use Gradle Plugin Portal due to networking or security constraints.

Note	Although optional, we highly suggest instrumenting the build with our Common Custom User Data Gradle plugin as well, as it will provide more details about your build

Maven Auto-instrumentation

To enable build scan publishing for Maven builds, the configuration would look something like presented below (using https://develocity.mycompany.com as an example of Develocity server URL and Develocity Access Key as a name of a Shared Credential in Bamboo). You’d need to specify your Develocity server URL, select “Allow untrusted server” if applicable, select “Enables Develocity Maven extension auto-injection” and, if required, specify the name of the Bamboo shared credential that holds the access key for authenticating with the Develocity server.

Note	Although optional, we highly suggest instrumenting the build with our Common Custom User Data Maven extension as well, as it will provide more details about your build

Gradle and Maven Auto-instrumentation

If you have both Gradle and Maven builds in Bamboo and would like to enable build scan publishing for all, you can simply merge the configuration like this

Usage

Once build is completed, you’ll be able to select a build scan link directly from the Job details page in the UI (the build scan link is also present under the Metadata section on the same page)

Auto-instrumentation compatibility

The following sections list the compatibility of the plugin with the Develocity version based on the given build tool in use.

For Gradle builds

For Gradle builds the version used for the Develocity Gradle plugin is defined in the Develocity Gradle plugin version field in the Gradle settings section of the configuration form. The compatibility of the specified version with Develocity can be found here.

For the optional Common Custom User Data Gradle plugin which is defined the same form, you can see the compatibility of the specified version with the Develocity Gradle plugin here.

For Maven builds

For Maven builds the version of the Develocity Maven extension is bundled into the plugin, meaning that the user can’t change what version the Maven build is instrumented with.

The following table shows the compatibility of the plugin version with Develocity:

Bamboo Plugin version	Develocity Maven extension version	Common Custom User Data Maven extension version	Minimum supported Develocity version
Next version	1.23	2.0.1	2024.3
2.2.3	1.23	2.0.1	2024.3
2.2.2	1.22.2	2.0.1	2024.2
2.2.1	1.22	2.0	2024.2
2.2.0	1.21.2	2.0	2024.1
2.1.0	1.21.1	2.0	2024.1
2.0.0	1.20.1	1.12.4	2023.4
1.3.0	1.20.1	1.12.4	2023.4
1.2.0	1.18.1	1.12.2	2023.2
1.1.2	1.18.1	1.12.2	2023.2
1.1.1	1.17.4	1.12.1	2023.1
1.1.0	1.16.6	1.11.1	2022.4
1.0.0	1.16.4	1.11.1	2022.4

License

This plugin is available under the Apache License, Version 2.0.