spring-boot icon indicating copy to clipboard operation
spring-boot copied to clipboard

Published 20 hours ago • verified publisher icon paketo-buildpacks
→

Metadata

A Cloud Native Buildpack that contributes Spring Boot dependency information and slices an application into multiple layers

gcr.io/paketo-buildpacks/spring-boot

The Paketo Buildpack for Spring Boot is a Cloud Native Buildpack that contributes Spring Boot dependency information and slices an application into multiple layers.

Behavior

This buildpack will always detect.

This buildpack will participate at build time if all the following conditions are met:

  • <APPLICATION_ROOT>/META-INF/MANIFEST.MF contains a Spring-Boot-Version entry

The buildpack will do the following:

  • Contributes Spring Boot version to org.springframework.boot.version image label
  • If <APPLICATION_ROOT>/META-INF/dataflow-configuration-metadata.properties exists
    • Contributes Spring Boot configuration metadata to org.springframework.boot.spring-configuration-metadata.json image label
    • Contributes Spring Cloud Data Flow configuration metadata to org.springframework.cloud.dataflow.spring-configuration-metadata.json image label
  • Contributes Implementation-Title manifest entry to org.opencontainers.image.title image label
  • Contributes Implementation-version manifest entry to org.opencontainers.image.version image label
  • Contributes dependency information extracted from Maven naming conventions to the image's BOM
  • When contributing to a JVM application:
    • Contributes Spring Cloud Bindings as an application dependency
      • This enables bindings-aware Spring Boot auto-configuration when CNB bindings are present during launch
    • If <APPLICATION_ROOT>/META-INF/MANIFEST.MF contains a Spring-Boot-Layers-Index entry
      • Contributes application slices as defined by the layer's index
    • If the application is a reactive web application
      • Configures $BPL_JVM_THREAD_COUNT to 50
  • When contributing to a native image application:
    • Adds classes from the executable JAR and entries from classpath.idx to the build-time class path, so they are available to native-image

Configuration

Environment Variable Description
$BP_SPRING_CLOUD_BINDINGS_DISABLED Whether to contribute Spring Cloud Bindings support to the image at build time. Defaults to false.
$BPL_SPRING_CLOUD_BINDINGS_DISABLED Whether to auto-configure Spring Boot environment properties from bindings at runtime. This requires Spring Cloud Bindings to have been installed at build time or it will do nothing. Defaults to false.
$BPL_SPRING_CLOUD_BINDINGS_ENABLED Deprecated in favour of $BPL_SPRING_CLOUD_BINDINGS_DISABLED. Whether to auto-configure Spring Boot environment properties from bindings at runtime. This requires Spring Cloud Bindings to have been installed at build time or it will do nothing. Defaults to true.

Bindings

The buildpack optionally accepts the following bindings:

Type: dependency-mapping

Key Value Description
<dependency-digest> <uri> If needed, the buildpack will fetch the dependency with digest <dependency-digest> from <uri>

License

This buildpack is released under version 2.0 of the Apache License.

← Metadata

155
Stars
21
Forks
Watchers

Owner

verified publisher icon paketo-buildpacks

Metadata

A Cloud Native Buildpack that contributes Spring Boot dependency information and slices an application into multiple layers

Back