Inspired by https://github.com/spring-io/develocity-conventions, this plugin configures public Gradle projects to use the public Develocity instance at ge.gradle.org.

Requires Java 17+ and Gradle 8.14+ and Develocity plugin 4.2+.

When applied as a settings plugin alongside the Develocity Plugin, this plugin does the following:

• If the build cache is enabled (via --build-cache or org.gradle.caching=true, see the doc):
  • Enable the local cache.
  • Enable ge.gradle.org as remote cache if credentials are provided, enjoy faster build! (using your preferred location)
  • Enable ge.gradle.org as remote cache and anonymous read access, enjoy faster build!
    • There are four build cache node available on the earth: Develocity (the default; Germany) /eu (Finland) /us (N.California) /au (Sydney), you can use -DcacheNode=eu/ -DcacheNode=us/-DcacheNode=au to use other ones.
  • Enable pushing to remote cache on CI if required credentials are provided.
• By default, build scans are published to ge.gradle.org. If you would like to publish to your own Develocity server, add -Ddevelocity.server.url=https://ge.mycompany.com/. If you would like to publish to public build scan server (scan.gradle.com), add -DagreePublicBuildScanTermOfService=yes to your build.
  • For CI build (CI environment variable exists):
    • Add CI build scan tag.
    • Add build scan link and build scan custom value gitCommitId to the build (by auto-detecting environment variables):
      • GitHub Actions: ${System.getenv("GITHUB_RUN_ID")} ${System.getenv("GITHUB_RUN_NUMBER")}/https://github.com/gradle/gradle/runs/${System.getenv("GITHUB_RUN_ID")}
      • TeamCity: BUILD_ID/BUILD_URL
    • Upload build scans in the foreground.
  • For local build:
    • Add LOCAL build scan tag.
    • Add build scan custom value gitCommitId by running git rev-parse --verify HEAD.
    • If running in IDEA:
      • Add IDEA build scan tag.
      • Add build scan custom value ideaVersion to IDEA version.
    • Upload build scans in the background.
  • For CI and local builds:
    • Add build scan custom value gitBranchName by running git rev-parse --abbrev-ref HEAD.
    • If the build directory is dirty:
      • Add build scan tag dirty
      • Add build scan custom value gitStatus with the output of git status --porcelain

The plugin is published to gradle plugin portal.

This is done by configuring a plugin management repository in settings.gradle, as shown in the following example:

plugins {
    // …
    id("com.gradle.develocity").version("<version>")
    id("io.github.gradle.develocity-conventions-plugin").version("<version>")
    // …
}

To enable build scan publishing, authenticate with Develocity. Then add a develocity.server.url system property to your build if you publish to a different server than the default one.

./gradlew myBuildTask -Ddevelocity.server.url=https://ge.mycompany.com/

To enable build cache pushing, the access key associated with the build needs to have build cache write permission.

export GRADLE_CACHE_REMOTE_URL=https://ge.mycompany.com/
./gradlew myBuildTask 

./gradlew myBuildTask -Dgradle.cache.remote.server=https://ge.mycompany.com/

To enable build scan publishing, you need to correctly authenticate as documented here.

Feel free to fork this repository, customize the plugin, and make a contribution!

You can install the plugin to local maven repository via:

./gradlew publishPluginMavenPublicationToMavenLocal

Then use the plugin under development via:

buildscript {
    repositories { 
        mavenLocal() 
    }
    dependencies {
        classpath("io.github.gradle:develocity-conventions-plugin:${thePluginVersion}")
    }
}

plugins {
    id("com.gradle.develocity").version("4.0.1")
}

apply(plugin= "io.github.gradle.develocity-conventions-plugin")