This guide is most relevant to platform operators.
See the spec release for Platform API 0.6 for the full list of changes and further details.
The exporter
will no longer set the default process type if none is specified (even if there is only one process). Buildpacks implementing Buildpack API 0.6 or greater may set the default process type, or it may be specified by passing -process-type
to the exporter
. To enable buildpacks implementing older Buildpack APIs to work with newer buildpacks, the lifecycle will assume that buildpacks that implement Buildpack API less than 0.6 intended for web
processes to be the default.
The detector
will now look for order.toml
in <layers>
before checking other paths. This enables platforms to write order.toml
into a mounted <layers>
directory and override the builder’s order.toml
without knowing where it is saved on the builder.
The working directory on the exported image config will match the value of CNB_APP_DIR
. This means that when running the image, processes started without the launcher will still use the app directory as the working directory.
Lifecycle exit codes are condensed to be within 0-255 so that they are understandable when surfaced in Bash. Platforms should take note of the new values when interpreting exit codes returned by the lifecycle. See the lifecycle component pages for more information.
The report.toml output by the exporter will now include the image manifest size in bytes. Note that this only applies to published images, as images exported to a docker daemon will not have a manifest.