File tree Expand file tree Collapse file tree 2 files changed +45
-0
lines changed
content/reference/compose-file Expand file tree Collapse file tree 2 files changed +45
-0
lines changed Original file line number Diff line number Diff line change @@ -424,11 +424,52 @@ build:
424424 privileged: true
425425` ` `
426426
427+ # ## `provenance`
428+
429+ {{< summary-bar feature_name="Compose provenance" >}}
430+
431+ ` provenance` configures the builder to add a [provenance attestation](https://slsa.dev/provenance/v0.2#schema) to the published image.
432+
433+ The value can be either a boolean to enable/disable provenance attestation, or a key=value string to set provenance configuration. You can
434+ use this to select the level of detail to be included in the provenance attestation by setting the `mode` parameter.
435+
436+ ` ` ` yaml
437+ build:
438+ context: .
439+ provenance: true
440+ ` ` `
441+
442+ ` ` ` yaml
443+ build:
444+ context: .
445+ provenance: mode=max
446+ ` ` `
447+
427448# ## `pull`
428449
429450` pull` requires the image builder to pull referenced images (`FROM` Dockerfile directive), even if those are already
430451available in the local image store.
431452
453+ # ## `sbom`
454+
455+ {{< summary-bar feature_name="Compose sbom" >}}
456+
457+ ` sbom` configures the builder to add a [provenance attestation](https://slsa.dev/provenance/v0.2#schema) to the published image.
458+ The value can be either a boolean to enable/disable sbom attestation, or a key=value string to set SBOM generator configuration. This let you
459+ select an alternative SBOM generator image (see https://github.com/moby/buildkit/blob/master/docs/attestations/sbom-protocol.md)
460+
461+ ` ` ` yaml
462+ build:
463+ context: .
464+ sbom: true
465+ ` ` `
466+
467+ ` ` ` yaml
468+ build:
469+ context: .
470+ sbom: generator=docker/scout-sbom-indexer:latest # Use an alternative SBOM generator
471+ ` ` `
472+
432473# ## `secrets`
433474
434475` secrets` grants access to sensitive data defined by [secrets](services.md#secrets) on a per-service build basis. Two
Original file line number Diff line number Diff line change @@ -125,10 +125,14 @@ Compose post start:
125125 requires : Docker Compose [2.30.0](/manuals/compose/releases/release-notes.md#2300) and later
126126Compose pre stop :
127127 requires : Docker Compose [2.30.0](/manuals/compose/releases/release-notes.md#2300) and later
128+ Compose provenance :
129+ requires : Docker Compose [2.39.0](/manuals/compose/releases/release-notes.md#2390) and later
128130Compose uts :
129131 requires : Docker Compose [2.15.1](/manuals/compose/releases/release-notes.md#2151) and later
130132Composefile include :
131133 requires : Docker Compose [2.20.0](/manuals/compose/releases/release-notes.md#2200) and later
134+ Compose sbom :
135+ requires : Docker Compose [2.39.0](/manuals/compose/releases/release-notes.md#2390) and later
132136containerd :
133137 availability : Experimental
134138Dev Environments :
You can’t perform that action at this time.
0 commit comments