This repository is maintained by the Develocity Solutions team, as one of several publicly available repositories:
The sbt Develocity Common Custom User Data plugin enhances published Build Scan data by adding a set of tags, links and custom values that have proven to be useful for many projects building with Develocity.
You can leverage this plugin for your project in one of two ways:
- Apply the published plugin directly in your build and immediately benefit from an enhanced Build Scan
- Copy this repository and develop a customized version of the plugin to standardize Develocity usage across multiple projects
The sbt Develocity Common Custom User Data plugin is available on Maven Central and requires the sbt Develocity plugin to be applied in your build to function.
To activate the sbt Develocity Common Custom User Data plugin, add it to your project's project/plugins.sbt file, where you've already declared the main sbt Develocity plugin.
addSbtPlugin("com.gradle" % "sbt-develocity-common-custom-user-data" % "1.1")
For an example, see the plugins.sbt file.
This table details the version compatibility of the sbt Develocity Common Custom User Data plugin with the sbt Develocity plugin.
| sbt Develocity Common Custom User Data plugin (this) versions | sbt Develocity plugin versions | sbt versions |
|---|---|---|
| 1.0 | 1.0 | 1.6.0+ |
| 1.1 | 1.1.2 | 1.6.0+ |
The additional tags, links and custom values captured by this plugin include:
- A tag representing the operating system
- A tag representing how the build was invoked, be that from your IDE (IDEA, Eclipse) or from the command-line
- A tag representing builds run on CI, together with a set of tags, links and custom values specific to the CI server running the build
- For Git repositories, when running the build in CI, information on the commit id, branch name, status, and whether the checkout is dirty
See CustomBuildScanEnhancements.scala for details on what data is captured and under which conditions.
This plugin also allows overriding various Develocity related settings via system properties and environment variables:
- Develocity general configuration
See Overrides.scala for the override behavior.
You can use the system properties and environment variables to override Develocity related settings temporarily without having to modify the build scripts. For example, to change the Develocity server when running a build:
sbt -Ddevelocity.url=https://ge.solutions-team.gradle.com/ runClick to see the complete set of available system properties and environment variables in the table below.
| Develocity API | System property | Environment variable |
|---|---|---|
| develocity.server | develocity.url | DEVELOCITY_URL |
| develocity.allowUntrustedServer | develocity.allowUntrustedServer | DEVELOCITY_ALLOWUNTRUSTEDSERVER |
For more flexibility, we recommend creating a copy of this repository so that you may develop a customized version of the plugin and publish it internally for your projects to consume.
This approach has a number of benefits:
- Tailor the Build Scan enhancements to exactly the set of tags, links and custom values you require
- Standardize the configuration for connecting to Develocity and the remote build cache in your organization, removing the need for each project to specify this configuration
If your customized plugin includes all necessary Develocity configurations, consuming projects will automatically gain the full benefits of Develocity by applying your plugin. The project sources offer an excellent template for creating your own plugin.
Refer to the Javadoc for more details on the key types available for use.
Refer to the release history to see detailed changes on the versions.
Visit our website to learn more about Develocity.
The sbt Develocity Common Custom User Data plugin is open-source software released under the Apache 2.0 License.