This Gradle plugin can be used for generating git.properties file generation for Git-based projects (similar to maven git commit id plugin). It can be used for (but not limited to) Spring Boot apps.
Plugin is available from Gradle Plugins repository.
Idea - @lievendoclo, originally published in article Spring Boot's info endpoint, Git and Gradle - InsaneProgramming.
This Gradle plugin is compatible with the following versions of Gradle:
| Plugin version | Min. Gradle version |
|---|---|
| 2.3.2 | 5.1 |
| 2.2.4 | 4.x |
- Plugin requires Java 8+
- If
git.propertiesis missing on Gradle 5.1.x and 5.2.x Issue 128, usegitPropertiesResourceDirto config a different output directory - Since gradle-git-properties v2.x, we require JGit 5.x, this might cause some issues if you have other gradle plugin which uses JGit 1.4.x. In that case, you can use gradle-git-properties v1.5.x (instead of 2.x) which uses JGit 1.4.x. See Issue 133 for more info about this plugin's dependencies
- With gradle-git-properties v2.2.4, v2.3.0, and v2.3.1, grgit v4.1.0 always requires the latest JGit which can be 6+, this cause build fails if you run Gradle with Java under 11. See Issue 195 for more info about this issue
Declare this in your build.gradle
plugins {
id "com.gorylenko.gradle-git-properties" version "2.4.0"
}A git.properties file will be generated when building Java-based projects (the plugin will configure any existing classes task to depend on generateGitProperties task - which is responsible for generated git.properties file). For non-Java projects, generateGitProperties task must be executed explicitly to generate git.properties file. The git repository for the project will be used.
Spring Boot specific info: This is enough to see git details via info endpoint of spring-boot-actuator.
If needed - override folder and file name of the generated file using gitPropertiesName and gitPropertiesResourceDir config keys.
(NOTE: By default, the file will be generated at build/resources/main/git.properties)
gitProperties {
// Customize file name (could be a file name or a relative file path below gitPropertiesResourceDir dir)
gitPropertiesName = "my-git-file.properties"
// Customize directory using gitPropertiesResourceDir config
// The directory in this config key is also added as a classpath entry
// (so the git.properties file will be included in the final JAR file)
gitPropertiesResourceDir = "${project.rootDir}/my/generated-resources-dir"
// (Deprecated, for compatibility only)
// Customize directory using gitPropertiesDir config
gitPropertiesDir = "${project.rootDir}/your/custom/dir"
}Please note that
spring-boot-actuatorexpectsgit.propertiesto be available at certain location.
If needed - use dateFormat and dateFormatTimeZone to format git.commit.time property (See SimpleDateFormat and TimeZone for valid values)
gitProperties {
dateFormat = "yyyy-MM-dd'T'HH:mmZ"
dateFormatTimeZone = "PST"
}Note: Kotlin DSL syntax
configure<com.gorylenko.GitPropertiesPluginExtension> { dateFormat = "yyyy-MM-dd'T'HH:mmZ" }If needed - use branch to override git branch name (when it cannot be detected correctly from environment variables/working directory)
gitProperties {
branch = System.getenv('GIT_BRANCH')
}By default, all git properties which are supported by the plugin will be generated:
git.branch
git.build.host
git.build.user.email
git.build.user.name
git.build.version
git.closest.tag.commit.count
git.closest.tag.name
git.commit.id
git.commit.id.abbrev
git.commit.id.describe
git.commit.message.full
git.commit.message.short
git.commit.time
git.commit.user.email
git.commit.user.name
git.dirty
git.remote.origin.url
git.tags
git.total.commit.count
You can have more fine-grained control of the content of git.properties using keys:
gitProperties {
keys = ['git.branch','git.commit.id','git.commit.time']
}Custom properties can be added with customProperty (supports both expressions and closures):
gitProperties {
customProperty 'greeting', 'Hello' // expression
customProperty 'my_custom_git_id', { it.head().id } // closure, 'it' is an instance of org.ajoberstar.grgit.Grgit
customProperty 'project_version', { project.version } // closure
}You can also replace standard properties using customProperty. In the below example, the logic it.describe(tags: true) will replace the plugin's logic which using describe(tags: false)
gitProperties {
// using any tags (not limited to annotated tags) for "git.commit.id.describe" property
// see http://ajoberstar.org/grgit/grgit-describe.html for more info about the describe method and available parameters
// 'it' is an instance of org.ajoberstar.grgit.Grgit
customProperty 'git.commit.id.describe', { it.describe(tags: true) }
}Spring Boot specific info: By default, the
infoendpoint exposes onlygit.branch,git.commit.id, andgit.commit.timeproperties (even then there are more in yourgit.properties). In order to expose all available properties, set the "management.info.git.mode" property to "full" per the Spring Boot documentation, e.g. in application.properties:management.info.git.mode=full
The .git directory for the project should be detected automatically, otherwise it can be specified manually using dotGitDirectory:
gitProperties {
dotGitDirectory = "${project.rootDir}/../somefolder/.git"
}Note: Kotlin DSL syntax
configure<com.gorylenko.GitPropertiesPluginExtension> {
(dotGitDirectory as DirectoryProperty).set("${project.rootDir}/../somefolder/.git")
}If for some reason, the .git directory for the project doesn't exist and you don't want the task to fail in that case, use failOnNoGitDirectory=false:
gitProperties {
failOnNoGitDirectory = false
}To skip plugin execution completely, configure the enabled property:
tasks.withType(com.gorylenko.GenerateGitPropertiesTask).all { enabled = false }When using with Spring Boot: This is raw JSON from info endpoint (with management.info.git.mode=simple or not configured):
{
"git": {
"commit": {
"time": "2018-03-28T05:13:53Z",
"id": "32ff212"
},
"branch": "Fix_issue_68"
}
}This is raw JSON from info endpoint (with management.info.git.mode=full):
{
"git": {
"build": {
"host": "myserver-1",
"version": "0.0.1-SNAPSHOT",
"user": {
"name": "First Last",
"email": "username1@example.com"
}
},
"branch": "Fix_issue_68",
"commit": {
"message": {
"short": "Fix issue #68",
"full": "Fix issue #68"
},
"id": {
"describe": "v1.4.21-28-g32ff212-dirty",
"abbrev": "32ff212",
"full": "32ff212b9e2873fa4672f1b5dd41f67aca6e0731"
},
"time": "2018-03-28T05:13:53Z",
"user": {
"email": "username1@example.com",
"name": "First Last"
}
},
"closest": {
"tag": {
"name": "v1.4.21",
"commit": {
"count": "28"
}
}
},
"dirty": "true",
"remote": {
"origin": {
"url": "git@github.com:n0mer/gradle-git-properties.git"
}
},
"tags": "",
"total": {
"commit": {
"count": "93"
}
}
}
}This plugin can also be used for other purposes (by configuring extProperty to keep generated properties and accessing the properties from project.ext).
Note that the git.properties file is always generated and currently there is no option to disable it.
Please also make sure that the generateGitProperties task is executed before accessing the generated properties.
In the below example, printGitProperties will print git.commit.id.abbrev property when it is executed:
gitProperties {
extProperty = 'gitProps' // git properties will be put in a map at project.ext.gitProps
}
generateGitProperties.outputs.upToDateWhen { false } // make sure the generateGitProperties task always executes (even when git.properties is not changed)
task printGitProperties(dependsOn: 'generateGitProperties') { // make sure generateGitProperties task to execute before accessing generated properties
doLast {
println "git.commit.id.abbrev=" + project.ext.gitProps['git.commit.id.abbrev']
}
}Below is another example about using generated properties for MANIFEST.MF of a Spring Boot webapp (similar can be done for non Spring apps). Note the usage of GString lazy evaluation to delay evaluating project.ext.gitProps['git.commit.id.abbrev'] until MANIFEST.MF is created. Because generateGitProperties task will always execute automatically before any classes task (in Java projects), no dependsOn is needed for bootJar task.
gitProperties {
extProperty = 'gitProps' // git properties will be put in a map at project.ext.gitProps
}
generateGitProperties.outputs.upToDateWhen { false } // make sure the generateGitProperties task always executes (even when git.properties is not changed)
bootJar {
manifest {
attributes(
'Build-Revision': "${-> project.ext.gitProps['git.commit.id.abbrev']}" // Use GString lazy evaluation to delay until git properties are populated
)
}
}Note: Kotlin DSL syntax (similar to above GString example)
// [...]
put("Implementation-Version", object {
override fun toString():String = (project.extra["gitProps"] as Map<String, String>)["git.commit.id"]!!
})
// [...]If you need to use a specific JGit version (e.g. because of version conflict), check the below example:
buildscript {
repositories {
maven {
url "https://plugins.gradle.org/m2/"
}
}
dependencies {
classpath ("com.gorylenko.gradle-git-properties:gradle-git-properties:2.4.0") {
exclude group: 'org.eclipse.jgit', module: 'org.eclipse.jgit' // remove plugin's jgit dependency
}
classpath 'org.eclipse.jgit:org.eclipse.jgit:5.5.0.201909110433-r' // use the specified jgit dependency
}
}
apply plugin: "com.gorylenko.gradle-git-properties"
apply plugin: 'java'gradle-git-properties is Open Source software released under the Apache 2.0 license