GitLab CI
Prerequisites

  • You have a Develocity server URL and access key.

  • GitLab CI/CD is configured for your project or group.

  • For sbt, npm, and Python builds, the Develocity plugin or extension must already be configured in your build. See the documentation for sbt, npm, or Python. For Gradle and Maven builds, the templates configure the plugin or extension at the CI level — no changes to your build scripts are required. See the documentation for Gradle or Maven.

Use the Develocity GitLab Templates

The Develocity GitLab templates configure the Develocity Gradle plugin or Maven extension at the CI level, publishing a Build Scan without modifying your Gradle or Maven build scripts.

Include the templates in your .gitlab-ci.yml and set the required CI/CD variables. Refer to the Develocity GitLab Templates repository for the full include: configuration and the list of supported variables.

Store the Access Key as a CI/CD Variable

Store your Develocity access key as a GitLab CI/CD variable named DEVELOCITY_ACCESS_KEY. Mark it as Masked to prevent the value from appearing in job logs.

The access key value uses the format «server host name»=«access key»:

develocity.example.com=7w5kbqqjea4vonghohvuyra5bnvszop4asbqee3m3sm6dbjdudtq

Verify the Integration

After your first pipeline run, open your Develocity server and navigate to Build Scan. Your build should appear there. Install the Common Custom User Data plugin to tag builds as CI and enrich each Build Scan with the Git branch, commit SHA, and a link back to the GitLab CI pipeline.