docs: clarify prov defaults

Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
This commit is contained in:
Sertac Ozercan 2023-02-22 20:38:10 +00:00
parent 4db5b7087c
commit 0ab146875b
No known key found for this signature in database
GPG Key ID: D82179482D8D885B
1 changed files with 11 additions and 1 deletions

View File

@ -49,6 +49,16 @@ You can opt in to add either the SBOM or provenance attestation type, or both.
$ docker buildx build --sbom=true --provenance=true .
```
> SBOM generation is not enabled by default. It must be opted in using `--sbom=true` option.
>
> However, provenance generation is enabled by default with `mode=min,inline-only=true` option.
>
> It can be disabled by setting `--provenance=false` or using `BUILDX_NO_DEFAULT_ATTESTATIONS` environment variable.
>
> If explicitly enabled using `--provenance=true`, provenance attestation is created with `mode=max` option by default.
>
> See [Provenance attestation](./slsa-provenance.md) section for more details.
BuildKit generates the attestations when building the image. The attestation
records are wrapped in the in-toto JSON format and attached it to the image
index in a manifest for the final image.