diff --git a/docs/manuals/cache/backends/index.md b/docs/manuals/cache/backends/index.md index 1fe6dc38..7d3063ae 100644 --- a/docs/manuals/cache/backends/index.md +++ b/docs/manuals/cache/backends/index.md @@ -101,7 +101,8 @@ The common parameters described here are: ### Cache mode When generating a cache output, the `--cache-to` argument accepts a `mode` -option for defining which layers to include in the exported cache. +option for defining which layers to include in the exported cache. This is +supported by all cache backends except for the `inline` cache. Mode can be set to either of two options: `mode=min` or `mode=max`. For example, to build the cache with `mode=max` with the registry backend: @@ -128,7 +129,8 @@ with both parameters to find the results that work best for you. ### Cache compression The cache compression options are the same as the -[exporter compression options](../../exporters/index.md#compression). +[exporter compression options](../../exporters/index.md#compression). This is +supported by the `local` and `registry` cache backends. For example, to compress the `registry` cache with `zstd` compression: @@ -141,7 +143,8 @@ $ docker buildx build --push -t / \ ### OCI media types The cache OCI options are the same as the -[exporter OCI options](../../exporters/index.md#oci-media-types). +[exporter OCI options](../../exporters/index.md#oci-media-types). These are +supported by the `local` and `registry` cache backends. For example, to export OCI media type cache, use the `oci-mediatypes` property: diff --git a/docs/manuals/cache/backends/inline.md b/docs/manuals/cache/backends/inline.md index f6ff07d2..06f36a9e 100644 --- a/docs/manuals/cache/backends/inline.md +++ b/docs/manuals/cache/backends/inline.md @@ -16,6 +16,8 @@ $ docker buildx build --push -t / \ --cache-from type=registry,ref=/image . ``` +No additional parameters are supported for the `inline` cache. + To export cache using `inline` storage, pass `type=inline` to the `--cache-to` option: diff --git a/docs/manuals/exporters/index.md b/docs/manuals/exporters/index.md index 71a5bae2..3daf2508 100644 --- a/docs/manuals/exporters/index.md +++ b/docs/manuals/exporters/index.md @@ -245,8 +245,8 @@ the previous compression algorithm. ### OCI media types Exporters that output container images, support creating images with either -Docker media types or with OCI media types. By default, BuildKit exports images -using Docker media type. +Docker media types (the default) or with OCI media types. This is supported by +the `image`, `registry`, `oci` and `docker` exporters. To export images with OCI media types set, use the `oci-mediatypes` property. For example, with the `image` exporter: @@ -260,7 +260,8 @@ $ docker buildx build \ Exporters that output container images, allow embedding information about the build, including information on the original build request and sources used -during the build. +during the build. This is supported by the `image`, `registry`, `oci` and +`docker` exporters. This build info is attached to the image configuration: