This document details the version compatibility of components of Gradle Enterprise with other related components.

Gradle Enterprise Gradle plugin

Latest version: 3.4 (2020-07-23)

It is recommended to always use the latest version of the Gradle Enterprise Gradle plugin that is compatible with your Gradle Build Tool version and installed Gradle Enterprise version, as it will produce the most insightful build scans. See the Gradle Enterprise Gradle Plugin User Manual for more information on using the Gradle Enterprise Gradle plugin.

This plugin was previously named and referred to as the “build scan” plugin. With the release of Gradle 6.0 and version 3.0 of this plugin, it has been renamed to the “Gradle Enterprise” plugin. When being used with earlier than Gradle 6.0, it is still referred to and used as the “build scan” plugin.

Gradle Build Tool compatibility

Upgrading your Gradle version may require updating the Gradle Enterprise Gradle plugin version. The latest version of the plugin is guaranteed to be compatible with Gradle 5.0 onwards.

Gradle Build Tool versions Minimum plugin version Maximum plugin version

>= 6.0

3.0

3.4

5.0 - 5.6.4

2.0.2

3.4

4.1 - 4.10

1.8

1.16

4.0

1.7.4

1.16

2.0 - 3.5

1.0

1.16

< 2.0

not supported

not supported

Gradle Enterprise compatibility

Major or minor version updates to the Gradle Enterprise Gradle plugin indicate a compatibility change with Gradle Enterprise (e.g. 3.0 → 3.1 or 3.1 → 4.0). Patch number only updates (e.g. 3.0 → 3.0.1) do not affect compatibility.

Submitting a build scan with an incompatible Gradle Enterprise Gradle plugin version will result in a warning message and the submission will be rejected.

Gradle Enterprise versions Minimum plugin version Maximum plugin version

2020.3

1.0

3.4

2020.2

1.0

3.3.4

2020.1

1.0

3.2.1

2019.5

1.0

3.1.1

2019.4

1.0

3.1.1

2019.3.3 - 2019.3.5

1.0

3.0

2019.3 - 2019.3.2

1.0

2.4.2

2019.2

1.0

2.3

2019.1

1.0

2.2.1

2018.5

1.0

2.1

2018.4.2

1.0

2.0.2

2018.4 - 2018.4.1

1.0

1.16

2018.3

1.0

1.15.2

2018.2

1.0

1.13.4

2018.1

1.0

1.12.1

2017.7

1.0

1.11

2017.6

1.0

1.10.3

2017.5

1.0

1.9.1

2017.4

1.0

1.8

2017.3

1.0

1.7.4

2017.1 - 2017.2

1.0

1.6

2016.4

1.0

1.3

2016.3

1.0

1.1.1

2016.0 - 2016.2

1.0

1.0

Gradle Enterprise Maven extension

Latest version: 1.6.1 (2020-08-03)

It is recommended to always use the latest version of the extension that is compatible with your Apache Maven™ version and installed Gradle Enterprise version, as it will produce the most insightful build scans and provide the most performant build caching. See the Gradle Enterprise Maven Extension User Manual for more information on using the extension.

Apache Maven compatibility

The latest version of the extension is guaranteed to be compatible with Apache Maven 3.3.1 onwards.

Apache Maven versions Minimum extension version Maximum extension version

>= 3.3.1

1.0

1.6.1

< 3.3.1

not supported

not supported

Java runtime requirements

The latest version of the extension runs on Java 1.8 and above.

Java runtime version Minimum extension version Maximum extension version

>= 1.8

1.0

1.6.1

< 1.8

not supported

not supported

Gradle Enterprise compatibility

Major or minor version updates to the extension indicate a compatibility change with Gradle Enterprise (e.g. 1.0 → 1.1 or 1.0 → 2.0). Patch number only updates (e.g. 1.0 → 1.0.1) do not affect compatibility.

Submitting a build scan or accessing the build cache with an incompatible extension version will result in a warning message and the submission or request will be rejected.

Gradle Enterprise versions Minimum extension version Maximum extension version

2020.3

1.0

1.6.1

2020.2

1.0

1.5.3

2020.1

1.0

1.4.1

2019.5

1.0

1.3.6

2019.4

1.0

1.3.6

2019.3

1.0

1.2.8

2019.2

1.0

1.1.4

2019.1

1.0

1.0.8

< 2019.1

not supported

not supported

Build cache node

Latest version: 9.3 (2020-07-27)

It is recommended to always use the latest version of the build cache node. See the Build Cache Node User Manual for more information on using and installing a build cache node.

Gradle Enterprise compatibility

Major version updates to the remote cache node indicate a compatibility change with Gradle Enterprise (e.g. 1.0 → 2.0). Minor number only updates (e.g. 3.0 → 3.1) do not affect compatibility.

Gradle Enterprise versions Minimum build cache node version Maximum build cache node version

2020.3

1.0

9.3

2020.2

1.0

9.3

2020.1

1.0

9.3

2019.5

1.0

9.3

2019.4

1.0

9.3

2019.3.1

1.0

8.1

2019.3

1.0

7.1

2019.2

1.0

7.1

2019.1

1.0

7.1

2018.5

1.0

6.0

2018.4

1.0

5.2

2018.3

1.0

4.3

2018.2

1.0

4.3

2018.1

1.0

3.2

2017.7

1.0

3.2

2017.6

1.0

2.0

2017.5

1.0

1.2

2017.4

1.0

1.2

< 2017.4

not supported

not supported

Configuration schema

The YAML configuration schema is released at a different rate to that of the node. Nodes will always parse configuration files with a version less than the maximum schema version.

Schema versions can be downloaded from the build cache node manual Appendix B.

Build cache node version Maximum schema version

6.0+

2

4.2+

1

< 4.2

not supported

Jar version Java runtime requirements

Since build cache node 9.0 we require a Java 11 runtime to run the JAR version of the build cache node. Prior to this, Java 8 was required.

Build cache node version Minimum Java runtime version

9.0+

11

< 9.0

8

Gradle Enterprise Test Distribution Gradle plugin

Latest version: 1.1.1 (2020-07-29)

It is recommended to always use the latest version of the Gradle Enterprise Test Distribution Gradle plugin. See the Gradle Enterprise Test Distribution Gradle Plugin User Manual for more information on using the plugin.

Gradle Enterprise compatibility

Gradle Enterprise 2020.2 is the first release which supports test distribution.

Gradle Enterprise versions Minimum plugin version Maximum plugin version

2020.3

1.1

1.1.1

2020.2

1.0

1.0.2

< 2020.2

not supported

not supported

Gradle Build Tool compatibility

The minimum version for the Gradle Build Tool which works with test distribution is 5.4.

Gradle Build Tool version Minimum plugin version Maximum plugin version

5.4+

1.0

1.1.1

< 5.4

not supported

not supported

Test Retry Gradle plugin

When using the Test Retry Gradle plugin together with the Gradle Enterprise Test Distribution Gradle plugin, make sure to use the minimum required version as shown below:

Gradle Enterprise Test Distribution Gradle plugin Minimum Test Retry plugin version

1.0+

1.1.4

Gradle Enterprise Test Distribution agent

Latest version: 1.1.2 (2020-07-31)

It is recommended to always use the latest version of the Gradle Enterprise Test Distribution agent. See the Gradle Enterprise Test Distribution Agent User Manual for more information on using and installing a test distribution agent.

Gradle Enterprise compatibility

Gradle Enterprise 2020.2 is the first release which supports test distribution.

Gradle Enterprise versions Minimum agent version Maximum agent version

2020.3

1.1

1.1.2

2020.2

1.0

1.0

< 2020.2

not supported

not supported

Jar version Java runtime requirements

The Gradle Enterprise Test distribution agent requires a Java 11 runtime.

Test Distribution Agent Minimum Java runtime version

1.0+

11

Gradle Enterprise upgrade and backup restoration compatibility

Some older versions of Gradle Enterprise need to be upgraded via an intermediate version. The same behaviour applies to backups from older versions that are restored - these need the same upgrade compatibility to the current version as upgrading a Gradle Enterprise installation in-place.

At this time, all versions prior to 2018.5 must be upgraded via an intermediate version. In some rare circumstances later versions up to 2020.1.2 may also need an intermediate version, depending on database state. All other versions can be upgraded to the latest Gradle Enterprise directly.

If your installation needs an intermediate version installed in order to upgrade to the latest version, a message will be displayed (or logged in Kubernetes installations) when attempting to start the new Gradle Enterprise version, indicating that the previous version is not upgrade-compatible with the current version, and to contact Gradle support. A step-by-step process will then be provided by Gradle support to install the necessary intermediate version and finish any incomplete data migration, before then upgrading to the latest version.