@@ -304,24 +304,26 @@ Note that these variables aren't used to configure the build container;
304304they aren't available inside the build and they have no relation to the ` ENV ` instruction.
305305They're used to configure the Buildx client, or the BuildKit daemon.
306306
307- | Variable | Type | Description |
308- | --------------------------------------------------------------------------- | ----------------- | ---------------------------------------------------- |
309- | [ BUILDKIT_COLORS] ( #buildkit_colors ) | String | Configure text color for the terminal output. |
310- | [ BUILDKIT_HOST] ( #buildkit_host ) | String | Specify host to use for remote builders. |
311- | [ BUILDKIT_PROGRESS] ( #buildkit_progress ) | String | Configure type of progress output. |
312- | [ BUILDKIT_TTY_LOG_LINES] ( #buildkit_tty_log_lines ) | String | Number of log lines (for active steps in TTY mode). |
313- | [ BUILDX_BAKE_GIT_AUTH_HEADER] ( #buildx_bake_git_auth_header ) | String | HTTP authentication scheme for remote Bake files. |
314- | [ BUILDX_BAKE_GIT_AUTH_TOKEN] ( #buildx_bake_git_auth_token ) | String | HTTP authentication token for remote Bake files. |
315- | [ BUILDX_BAKE_GIT_SSH] ( #buildx_bake_git_ssh ) | String | SSH authentication for remote Bake files. |
316- | [ BUILDX_BUILDER] ( #buildx_builder ) | String | Specify the builder instance to use. |
317- | [ BUILDX_CONFIG] ( #buildx_config ) | String | Specify location for configuration, state, and logs. |
318- | [ BUILDX_EXPERIMENTAL] ( #buildx_experimental ) | Boolean | Turn on experimental features. |
319- | [ BUILDX_GIT_CHECK_DIRTY] ( #buildx_git_check_dirty ) | Boolean | Enable dirty Git checkout detection. |
320- | [ BUILDX_GIT_INFO] ( #buildx_git_info ) | Boolean | Remove Git information in provenance attestations. |
321- | [ BUILDX_GIT_LABELS] ( #buildx_git_labels ) | String \| Boolean | Add Git provenance labels to images. |
322- | [ BUILDX_NO_DEFAULT_ATTESTATIONS] ( #buildx_no_default_attestations ) | Boolean | Turn off default provenance attestations. |
323- | [ BUILDX_NO_DEFAULT_LOAD] ( #buildx_no_default_load ) | Boolean | Turn off loading images to image store by default. |
324- | [ EXPERIMENTAL_BUILDKIT_SOURCE_POLICY] ( #experimental_buildkit_source_policy ) | String | Specify a BuildKit source policy file. |
307+ | Variable | Type | Description |
308+ | --------------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------ |
309+ | [ BUILDKIT_COLORS] ( #buildkit_colors ) | String | Configure text color for the terminal output. |
310+ | [ BUILDKIT_HOST] ( #buildkit_host ) | String | Specify host to use for remote builders. |
311+ | [ BUILDKIT_PROGRESS] ( #buildkit_progress ) | String | Configure type of progress output. |
312+ | [ BUILDKIT_TTY_LOG_LINES] ( #buildkit_tty_log_lines ) | String | Number of log lines (for active steps in TTY mode). |
313+ | [ BUILDX_BAKE_GIT_AUTH_HEADER] ( #buildx_bake_git_auth_header ) | String | HTTP authentication scheme for remote Bake files. |
314+ | [ BUILDX_BAKE_GIT_AUTH_TOKEN] ( #buildx_bake_git_auth_token ) | String | HTTP authentication token for remote Bake files. |
315+ | [ BUILDX_BAKE_GIT_SSH] ( #buildx_bake_git_ssh ) | String | SSH authentication for remote Bake files. |
316+ | [ BUILDX_BUILDER] ( #buildx_builder ) | String | Specify the builder instance to use. |
317+ | [ BUILDX_CONFIG] ( #buildx_config ) | String | Specify location for configuration, state, and logs. |
318+ | [ BUILDX_CPU_PROFILE] ( #buildx_cpu_profile ) | String | Generate a ` pprof ` CPU profile at the specified location. |
319+ | [ BUILDX_EXPERIMENTAL] ( #buildx_experimental ) | Boolean | Turn on experimental features. |
320+ | [ BUILDX_GIT_CHECK_DIRTY] ( #buildx_git_check_dirty ) | Boolean | Enable dirty Git checkout detection. |
321+ | [ BUILDX_GIT_INFO] ( #buildx_git_info ) | Boolean | Remove Git information in provenance attestations. |
322+ | [ BUILDX_GIT_LABELS] ( #buildx_git_labels ) | String \| Boolean | Add Git provenance labels to images. |
323+ | [ BUILDX_MEM_PROFILE] ( #buildx_mem_profile ) | String | Generate a ` pprof ` memory profile at the specified location. |
324+ | [ BUILDX_NO_DEFAULT_ATTESTATIONS] ( #buildx_no_default_attestations ) | Boolean | Turn off default provenance attestations. |
325+ | [ BUILDX_NO_DEFAULT_LOAD] ( #buildx_no_default_load ) | Boolean | Turn off loading images to image store by default. |
326+ | [ EXPERIMENTAL_BUILDKIT_SOURCE_POLICY] ( #experimental_buildkit_source_policy ) | String | Specify a BuildKit source policy file. |
325327
326328BuildKit also supports a few additional configuration parameters. Refer to
327329[ BuildKit built-in build args] ( /reference/dockerfile.md#buildkit-built-in-build-args ) .
@@ -507,6 +509,22 @@ Usage:
507509$ export BUILDX_CONFIG=/usr/local/etc
508510```
509511
512+ ### BUILDX_CPU_PROFILE
513+
514+ {{< introduced buildx 0.18.0 >}}
515+
516+ If specified, Buildx generates a ` pprof ` CPU profile at the specified location.
517+
518+ > [ !NOTE]
519+ > This property is only useful for when developing Buildx. The profiling data
520+ > is not relevant for analyzing a build's performance.
521+
522+ Usage:
523+
524+ ``` console
525+ $ export BUILDX_CPU_PROFILE=buildx_cpu.prof
526+ ```
527+
510528### BUILDX_EXPERIMENTAL
511529
512530Enables experimental build features.
@@ -572,6 +590,23 @@ Usage:
572590
573591If the repository is in a dirty state, the ` revision ` gets a ` -dirty ` suffix.
574592
593+ ### BUILDX_MEM_PROFILE
594+
595+ {{< introduced buildx 0.18.0 >}}
596+
597+ If specified, Buildx generates a ` pprof ` memory profile at the specified
598+ location.
599+
600+ > [ !NOTE]
601+ > This property is only useful for when developing Buildx. The profiling data
602+ > is not relevant for analyzing a build's performance.
603+
604+ Usage:
605+
606+ ``` console
607+ $ export BUILDX_MEM_PROFILE=buildx_mem.prof
608+ ```
609+
575610### BUILDX_NO_DEFAULT_ATTESTATIONS
576611
577612{{< introduced buildx 0.10.4 "../release-notes.md#0104" >}}
0 commit comments