如需获取最新稳定版本,请使用 Spring Boot 4.0.4spring-doc.cadn.net.cn

与 Actuator 集成

生成构建信息

Spring Boot Actuator 的 info 端点在存在 META-INF/build-info.properties 文件时会自动发布有关您的构建的信息。 提供了一个 BuildInfo 任务来生成此文件。 使用该任务的最简单方法是通过插件的 DSL:spring-doc.cadn.net.cn

springBoot {
	buildInfo()
}
springBoot {
	buildInfo()
}

这将配置一个名为 BuildInfo任务,如果该任务存在,则使 Java 插件的 classes 任务依赖于它。 该任务的目标目录将是主源集资源输出目录下的 META-INF(通常为 build/resources/main)。spring-doc.cadn.net.cn

默认情况下,生成的构建信息是从项目中派生的:spring-doc.cadn.net.cn

属性 默认值

build.artifactspring-doc.cadn.net.cn

bootJarbootWar 任务的基本名称spring-doc.cadn.net.cn

build.groupspring-doc.cadn.net.cn

项目的组spring-doc.cadn.net.cn

build.namespring-doc.cadn.net.cn

项目名称spring-doc.cadn.net.cn

build.versionspring-doc.cadn.net.cn

项目的版本spring-doc.cadn.net.cn

build.timespring-doc.cadn.net.cn

项目构建的时间spring-doc.cadn.net.cn

可以使用 DSL 自定义这些属性:spring-doc.cadn.net.cn

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 属性:spring-doc.cadn.net.cn

springBoot {
	buildInfo {
		excludes = ['time']
	}
}
springBoot {
	buildInfo {
		excludes.set(setOf("time"))
	}
}

build.time 的默认值是项目构建时的瞬间时间。 这样做的一个副作用是,该任务将永远不会被视为最新(up-to-date)。 因此,由于必须执行更多任务(包括项目的测试),构建过程将会花费更长时间。 另一个副作用是,任务的输出将始终发生变化,因此构建将无法真正实现可重复性。 如果您认为构建性能或可重复性比 build.time 属性的准确性更重要,请如前例所示排除 time 属性。spring-doc.cadn.net.cn

还可以向构建信息中添加其他属性:spring-doc.cadn.net.cn

springBoot {
	buildInfo {
		properties {
			additional = [
				'a': 'alpha',
				'b': 'bravo'
			]
		}
	}
}
springBoot {
	buildInfo {
		properties {
			additional.set(mapOf(
				"a" to "alpha",
				"b" to "bravo"
			))
		}
	}
}

可以通过使用 Provider 来延迟计算附加属性的值。spring-doc.cadn.net.cn