This guide is most relevant to platform operators and builder authors.
See the spec release for Platform API 0.11 for the full list of changes and further details.
launcherare included in the application image
In Platform 0.11, the lifecycle ships with standardized SBOM files describing the
(these are included in the tarball on the GitHub release page and within the image at
After a build, SBOM files describing the
launcher are included in the application image at
<ext> is each of:
Additionally, SBOM files describing the
lifecycle are copied to
where they may be saved off by the platform prior to the build container exiting.
This mirrors what is already being done as of Platform 0.8 for buildpack-provided standardized SBOM files,
which are exported to
<layers>/sbom/launch/<buildpack-id>/<layer>/sbom.<ext> (for runtime dependencies)
and copied to
<layers>/sbom/launch/<buildpack-id>/sbom.<ext> (for build-time dependencies).
To use this feature, no additional action is required from platforms that are already handling buildpack-provided SBOM files. The SBOMs for the image will simply be more complete.
Previously, when rebasing an image, the rebased image would always be saved to the same tag as the original image. This prevented rebasing by digest, among other use cases.
In Platform 0.11, the original image may be specified separately from the destination image with the
previous-image flag, as in the following:
/cnb/lifecycle/rebaser -previous-image some-original-image some-destination-image
As before, additional tags for the destination image can also be provided:
/cnb/lifecycle/rebaser -previous-image some-original-image -tag some-additional-tag:latest some-destination-image
To use this feature, platforms can provide the new
-previous-image flag to the
Builders can include a
/cnb/build-config/env/ directory to define environment variables for buildpacks.
As an example, file
/cnb/build-config/env/SOME_VAR with contents
some-val will become
SOME_VAR=some-val in the buildpack environment.
Files in the
/cnb/build-config/env/ directory can use suffixes to control the behavior when another entity defines the same variable -
/cnb/build-config/env/SOME_VAR.override has contents
<platform>/env/SOME_VAR has contents
the buildpack environment will contain
This is similar to the environment modification rules for buildpacks,
except that the default behavior when no file suffix is provided is
The order of application for env directories is:
<platform>/env/- overrides buildpack values
For additional information, see the buildpack environment section in the Platform spec.
To use this feature, builder authors should include a
/cnb/build-config/env/ directory with the desired configuration.