Skip to content

Gradle plugin that enhances published build scans by adding a set of tags, links and custom values that have proven to be useful for many projects building with Develocity.

License

Notifications You must be signed in to change notification settings

gradle/common-custom-user-data-gradle-plugin

This repository is maintained by the Develocity Solutions team, as one of several publicly available repositories:

Common Custom User Data Gradle Plugin

Verify Build Plugin Portal Revved up by Develocity

The Common Custom User Data Gradle plugin for Develocity enhances published build scans 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:

  1. Apply the published plugin directly in your build and immediately benefit from enhanced build scans
  2. Copy this repository and develop a customized version of the plugin to standardize Develocity usage across multiple projects

Applying the published plugin

The Common Custom User Data Gradle plugin is available in the Gradle Plugin Portal. This plugin requires the Develocity Gradle plugin to also be applied in your build in order to have an effect.

In order for the Common Custom User Gradle plugin to become active, you need to register it in the settings.gradle(.kts) file of your project. The settings.gradle(.kts) file is the same file where you have already declared the Develocity Gradle plugin.

See here for an example.

Version compatibility

This table details the version compatibility of the Common Custom User Data Gradle plugin with the Develocity Gradle plugin.

Common Custom User Data Gradle plugin versions Develocity Gradle plugin versions Gradle version
1.0+ 3.0+ 5.0+
1.7+ 1.8+ 4.0+

Captured data

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, Android Studio) 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, information on the commit id, branch name, status, and whether the checkout is dirty or not

See CustomBuildScanEnhancements.java for details on what data is captured and under which conditions.

Configuration overrides

This plugin also allows overriding various Develocity related settings via system properties and environment variables:

  • Develocity general configuration
  • Remote build cache configuration
  • Local build cache configuration

See Overrides.java 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 disable the local build cache when running a build:

./gradlew -Dgradle.cache.local.enabled=false build
Click to see the complete set of available system properties and environment variables in the table below.

Develocity settings

Develocity API System property Environment variable
develocity.server develocity.url DEVELOCITY_URL
develocity.allowUntrustedServer develocity.allowUntrustedServer DEVELOCITY_ALLOWUNTRUSTEDSERVER

Local Build Cache settings

Local Build Cache API System property Environment variable
buildCache.local.setEnabled gradle.cache.local.enabled GRADLE_CACHE_LOCAL_ENABLED
buildCache.local.setPush gradle.cache.local.push GRADLE_CACHE_LOCAL_PUSH
buildCache.local.setDirectory gradle.cache.local.directory GRADLE_CACHE_LOCAL_DIRECTORY
buildCache.local.setRemoveUnusedEntriesAfterDays gradle.cache.local.removeUnusedEntriesAfterDays GRADLE_CACHE_LOCAL_REMOVEUNUSEDENTRIESAFTERDAYS

HTTP Build Cache settings

HTTP Build Cache API System property Environment variable
buildCache.remote.setEnabled gradle.cache.remote.enabled GRADLE_CACHE_REMOTE_ENABLED
buildCache.remote.setPush gradle.cache.remote.push GRADLE_CACHE_REMOTE_PUSH
buildCache.remote.setAllowUntrustedServer gradle.cache.remote.allowUntrustedServer GRADLE_CACHE_REMOTE_ALLOWUNTRUSTEDSERVER
buildCache.remote.setAllowInsecureProtocol gradle.cache.remote.allowInsecureProtocol GRADLE_CACHE_REMOTE_ALLOWINSECUREPROTOCOL
buildCache.remote.setUrl gradle.cache.remote.url GRADLE_CACHE_REMOTE_URL

Develocity Build Cache settings

Develocity Build Cache API System property Environment variable
buildCache.remote.setEnabled gradle.cache.remote.enabled GRADLE_CACHE_REMOTE_ENABLED
buildCache.remote.setPush gradle.cache.remote.push GRADLE_CACHE_REMOTE_PUSH
buildCache.remote.setAllowUntrustedServer gradle.cache.remote.allowUntrustedServer GRADLE_CACHE_REMOTE_ALLOWUNTRUSTEDSERVER
buildCache.remote.setAllowInsecureProtocol gradle.cache.remote.setAllowInsecureProtocol GRADLE_CACHE_REMOTE_ALLOWINSECUREPROTOCOL
buildCache.remote.setServer gradle.cache.remote.server GRADLE_CACHE_REMOTE_SERVER
buildCache.remote.setPath gradle.cache.remote.path GRADLE_CACHE_REMOTE_PATH

Developing a customized version of the plugin

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 provides all required Develocity configuration, then a consumer project will get all the benefits of Develocity simply by applying the plugin. The project sources provide a good template to get started with your own plugin.

Refer to the Javadoc for more details on the key types available for use.

See the Gradle User Manual for more details on publishing Gradle plugins to an internal repository.

Changelog

Refer to the release history to see detailed changes on the versions.

Learn more

Visit our website to learn more about Develocity.

License

The Develocity Common Custom User Data Gradle plugin is open-source software released under the Apache 2.0 License.

About

Gradle plugin that enhances published build scans by adding a set of tags, links and custom values that have proven to be useful for many projects building with Develocity.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks