Skip to content
Snippets Groups Projects
Commit dad13562 authored by Sébastien Heurtematte's avatar Sébastien Heurtematte :speech_balloon:
Browse files

Merge branch 'gk/dv-docs-update2' into 'main'

Varuous docs improvements

See merge request !5
parents 989c3dbd 577fb94f
No related branches found
No related tags found
1 merge request!5Varuous docs improvements
Pipeline #63966 failed
...@@ -45,16 +45,12 @@ Generically, onboarding a project to Develocity consists of: ...@@ -45,16 +45,12 @@ Generically, onboarding a project to Develocity consists of:
The following sample shows a minimal Develocity configuration for a project building with Gradle 6 or above, using Groovy build scripts. A kotlin script sample (`setting.gradle.kts`) is available [here](https://github.com/gradle/develocity-build-config-samples/blob/main/common-develocity-gradle-configuration-kotlin/settings.gradle.kts). The following sample shows a minimal Develocity configuration for a project building with Gradle 6 or above, using Groovy build scripts. A kotlin script sample (`setting.gradle.kts`) is available [here](https://github.com/gradle/develocity-build-config-samples/blob/main/common-develocity-gradle-configuration-kotlin/settings.gradle.kts).
> **Important!** if your project is hosted on github, replace `System.getenv("EF_SHORT_NAME")` or `env['EF_SHORT_NAME']` with the real short name of your project, e.g: `eclipse-mylyn-bot`.
#### settings.gradle #### settings.gradle
> **Important!** if your project is hosted on github, replace `System.getenv("EF_SHORT_NAME")` with the real short name of your project, e.g: `eclipse-mylyn-bot`.
```groovy ```groovy
plugins { plugins {
id 'com.gradle.develocity' version '3.18.1' id 'com.gradle.develocity' version '3.19.1'
id 'com.gradle.common-custom-user-data-gradle-plugin' version '2.0.2' id 'com.gradle.common-custom-user-data-gradle-plugin' version '2.1'
} }
def isCI = System.getenv('CI') != null // adjust to your CI provider def isCI = System.getenv('CI') != null // adjust to your CI provider
...@@ -72,13 +68,13 @@ develocity { ...@@ -72,13 +68,13 @@ develocity {
} }
buildCache { buildCache {
// disable local caching in CI, unless already used by the build // disable local caching in CI, unless already used by the build on CI
local { local {
enabled = !isCI enabled = !isCI
} }
// disable remote caching, unless already used by the build or you want to use / experiment with it // disable remote caching, unless already used by the build or you want to use / experiment with it
remote(develocity.buildCache) { remote(develocity.buildCache) {
enabled = false enabled = true
push = isCI push = isCI
} }
} }
...@@ -103,7 +99,7 @@ The following sample shows a Develocity configuration for a Maven project: ...@@ -103,7 +99,7 @@ The following sample shows a Develocity configuration for a Maven project:
<extension> <extension>
<groupId>com.gradle</groupId> <groupId>com.gradle</groupId>
<artifactId>develocity-maven-extension</artifactId> <artifactId>develocity-maven-extension</artifactId>
<version>1.22.2</version> <version>1.23.1</version>
</extension> </extension>
<extension> <extension>
<groupId>com.gradle</groupId> <groupId>com.gradle</groupId>
...@@ -115,8 +111,6 @@ The following sample shows a Develocity configuration for a Maven project: ...@@ -115,8 +111,6 @@ The following sample shows a Develocity configuration for a Maven project:
#### .mvn/develocity.xml #### .mvn/develocity.xml
> **Important!** if your project is hosted on github, replace `env['EF_SHORT_NAME']` with the real short name of your project, e.g: `eclipse-mylyn-bot`.
```xml ```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<develocity <develocity
...@@ -139,10 +133,10 @@ The following sample shows a Develocity configuration for a Maven project: ...@@ -139,10 +133,10 @@ The following sample shows a Develocity configuration for a Maven project:
</buildScan> </buildScan>
<buildCache> <buildCache>
<local> <local>
<enabled>#{isFalse(env['CI'])}</enabled> <enabled>false</enabled> <!-- Set to true if you want to use / experiment with local caching. Alternatively you can also use #{isFalse(env['CI'])} -->
</local> </local>
<remote> <remote>
<enabled>false</enabled> <enabled>false</enabled> <!-- Set to true if you want to use / experiment with remote caching -->
<storeEnabled>#{isTrue(env['CI'])}</storeEnabled> <!-- adjust to your CI provider --> <storeEnabled>#{isTrue(env['CI'])}</storeEnabled> <!-- adjust to your CI provider -->
</remote> </remote>
</buildCache> </buildCache>
...@@ -172,6 +166,10 @@ https://docs.gradle.com/develocity/get-started/#integrating_your_ci_tool ...@@ -172,6 +166,10 @@ https://docs.gradle.com/develocity/get-started/#integrating_your_ci_tool
#### Jenkins #### Jenkins
> **Important:** The CI integration needs to be completed by the Eclipse Foundation IT team **before** the following configuration can be used. You can request it by filling a ticket on the [helpdesk](https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/issues/new).
> **Note:** The <project_id> should be taken from the [project.eclipse.org](http://project.eclipse.org/), for example https://projects.eclipse.org/projects/technology.escet -> `technology.escet` and not from [ci.eclipse.org](http://ci.eclipse.org/) path.
```groovy ```groovy
def secrets = [ def secrets = [
[path: 'cbi/<project_id>/develocity.eclipse.org', secretValues: [ [path: 'cbi/<project_id>/develocity.eclipse.org', secretValues: [
...@@ -190,7 +188,7 @@ pipeline { ...@@ -190,7 +188,7 @@ pipeline {
stage('Build') { stage('Build') {
steps { steps {
withVault([vaultSecrets: secrets]) { withVault([vaultSecrets: secrets]) {
sh 'mvn clean verify -Prelease -B' sh 'mvn clean install'
} }
} }
} }
...@@ -366,6 +364,8 @@ doc: https://docs.gradle.com/develocity/maven-extension/current/#obfuscating_ide ...@@ -366,6 +364,8 @@ doc: https://docs.gradle.com/develocity/maven-extension/current/#obfuscating_ide
#### Tags #### Tags
> **Note:** commonly added tags and other custom data (links, values) are added by the [Common Custom User Data Gradle Plugin](https://github.com/gradle/common-custom-user-data-gradle-plugin) or the [Common Custom User Data Maven Extension](https://github.com/gradle/common-custom-user-data-maven-extension).
1. Gradle: `build.gradle.kts` 1. Gradle: `build.gradle.kts`
doc: https://docs.gradle.com/develocity/gradle-plugin/current/#adding_tags doc: https://docs.gradle.com/develocity/gradle-plugin/current/#adding_tags
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment