@@ -543,6 +543,17 @@ inherited_options:
543543 experimentalcli : false
544544 kubernetes : false
545545 swarm : false
546+ - option : debug
547+ shorthand : D
548+ value_type : bool
549+ default_value : " false"
550+ description : Enable debug logging
551+ deprecated : false
552+ hidden : false
553+ experimental : false
554+ experimentalcli : false
555+ kubernetes : false
556+ swarm : false
546557examples : |-
547558 ### Add entries to container hosts file (--add-host) {#add-host}
548559
@@ -1060,8 +1071,7 @@ examples: |-
10601071 }
10611072 ```
10621073
1063- > **Note**
1064- >
1074+ > [!NOTE]
10651075 > Build record [provenance](/build/metadata/attestations/slsa-provenance/#provenance-attestation-example)
10661076 > (`buildx.build.provenance`) includes minimal provenance by default. Set the
10671077 > `BUILDX_METADATA_PROVENANCE` environment variable to customize this behavior:
@@ -1070,8 +1080,7 @@ examples: |-
10701080 > - `max` sets full provenance.
10711081 > - `disabled`, `false` or `0` doesn't set any provenance.
10721082
1073- > **Note**
1074- >
1083+ > [!NOTE]
10751084 > Build warnings (`buildx.build.warnings`) are not included by default. Set the
10761085 > `BUILDX_METADATA_WARNINGS` environment variable to `1` or `true` to
10771086 > include them.
@@ -1311,8 +1320,7 @@ examples: |-
13111320 Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use `plain` to show container
13121321 output (default `auto`).
13131322
1314- > **Note**
1315- >
1323+ > [!NOTE]
13161324 > You can also use the `BUILDKIT_PROGRESS` environment variable to set its value.
13171325
13181326 The following example uses `plain` output during the build:
@@ -1330,8 +1338,7 @@ examples: |-
13301338 ...
13311339 ```
13321340
1333- > **Note**
1334- >
1341+ > [!NOTE]
13351342 > Check also the [`BUILDKIT_COLORS`](/build/building/variables/#buildkit_colors)
13361343 > environment variable for modifying the colors of the terminal output.
13371344
@@ -1429,8 +1436,8 @@ examples: |-
14291436 # syntax=docker/dockerfile:1
14301437 FROM node:alpine
14311438 RUN --mount=type=bind,target=. \
1432- --mount=type=secret,id=SECRET_TOKEN \
1433- SECRET_TOKEN=$(cat /run/secrets/SECRET_TOKEN) yarn run test
1439+ --mount=type=secret,id=SECRET_TOKEN,env=SECRET_TOKEN \
1440+ yarn run test
14341441 ```
14351442
14361443 ```console
@@ -1446,8 +1453,7 @@ examples: |-
14461453 optional and can be `b` (bytes), `k` (kilobytes), `m` (megabytes), or `g`
14471454 (gigabytes). If you omit the unit, the system uses bytes.
14481455
1449- > **Note**
1450- >
1456+ > [!NOTE]
14511457 > In most cases, it is recommended to let the builder automatically determine
14521458 > the appropriate configurations. Manual adjustments should only be considered
14531459 > when specific performance tuning is required for complex build scenarios.
@@ -1533,14 +1539,12 @@ examples: |-
15331539 $ docker buildx build --ulimit nofile=1024:1024 .
15341540 ```
15351541
1536- > **Note**
1537- >
1542+ > [!NOTE]
15381543 > If you don't provide a `hard limit`, the `soft limit` is used
15391544 > for both values. If no `ulimits` are set, they're inherited from
15401545 > the default `ulimits` set on the daemon.
15411546
1542- > **Note**
1543- >
1547+ > [!NOTE]
15441548 > In most cases, it is recommended to let the builder automatically determine
15451549 > the appropriate configurations. Manual adjustments should only be considered
15461550 > when specific performance tuning is required for complex build scenarios.
0 commit comments