与 Actuator 集成
生成构建信息
Spring Boot Actuator 的 info 端点在存在 META-INF/build-info.properties 文件时会自动发布有关您的构建的信息。
提供了一个 BuildInfo 任务来生成此文件。
使用该任务的最简单方法是通过插件的 DSL:
-
Groovy
-
Kotlin
springBoot {
buildInfo()
}
springBoot {
buildInfo()
}
这将配置一个名为 BuildInfo 的 任务,如果该任务存在,则使 Java 插件的 classes 任务依赖于它。
该任务的目标目录将是主源集资源输出目录下的 META-INF(通常为 build/resources/main)。
默认情况下,生成的构建信息是从项目中派生的:
| 属性 | 默认值 |
|---|---|
|
|
|
项目的组 |
|
项目名称 |
|
项目的版本 |
|
项目构建的时间 |
可以使用 DSL 自定义这些属性:
-
Groovy
-
Kotlin
springBoot {
buildInfo {
properties {
artifact = 'example-app'
version = '1.2.3'
group = 'com.example'
name = 'Example application'
}
}
}
springBoot {
buildInfo {
properties {
artifact.set("example-app")
version.set("1.2.3")
group.set("com.example")
name.set("Example application")
}
}
}
要从生成的构建信息中排除任何默认属性,请将其名称添加到 excludes 中。
例如,可以按如下方式排除 time 属性:
-
Groovy
-
Kotlin
springBoot {
buildInfo {
excludes = ['time']
}
}
springBoot {
buildInfo {
excludes.set(setOf("time"))
}
}
build.time 的默认值是项目构建时的瞬间时间。
这样做的一个副作用是,该任务将永远不会被视为最新(up-to-date)。
因此,由于必须执行更多任务(包括项目的测试),构建过程将会花费更长时间。
另一个副作用是,任务的输出将始终发生变化,因此构建将无法真正实现可重复性。
如果您认为构建性能或可重复性比 build.time 属性的准确性更重要,请如前例所示排除 time 属性。
还可以向构建信息中添加其他属性:
-
Groovy
-
Kotlin
springBoot {
buildInfo {
properties {
additional = [
'a': 'alpha',
'b': 'bravo'
]
}
}
}
springBoot {
buildInfo {
properties {
additional.set(mapOf(
"a" to "alpha",
"b" to "bravo"
))
}
}
}
可以通过使用 Provider 来延迟计算附加属性的值。