mirror of
https://github.com/docker/docs.git
synced 2026-04-12 06:19:22 +07:00
139 lines
3.8 KiB
YAML
139 lines
3.8 KiB
YAML
command: docker buildx history export
|
|
short: Export build records into Docker Desktop bundle
|
|
long: |-
|
|
Export one or more build records to `.dockerbuild` archive files. These archives
|
|
contain metadata, logs, and build outputs, and can be imported into Docker
|
|
Desktop or shared across environments.
|
|
usage: docker buildx history export [OPTIONS] [REF...]
|
|
pname: docker buildx history
|
|
plink: docker_buildx_history.yaml
|
|
options:
|
|
- option: all
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Export all build records for the builder
|
|
details_url: '#all'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: finalize
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Ensure build records are finalized before exporting
|
|
details_url: '#finalize'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: output
|
|
shorthand: o
|
|
value_type: string
|
|
description: Output file path
|
|
details_url: '#output'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
inherited_options:
|
|
- option: builder
|
|
value_type: string
|
|
description: Override the configured builder instance
|
|
details_url: '#builder'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: debug
|
|
shorthand: D
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Enable debug logging
|
|
details_url: '#debug'
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
### Export all build records to a file (--all) {#all}
|
|
|
|
Use the `--all` flag and redirect the output:
|
|
|
|
```console
|
|
docker buildx history export --all > all-builds.dockerbuild
|
|
```
|
|
|
|
Or use the `--output` flag:
|
|
|
|
```console
|
|
docker buildx history export --all -o all-builds.dockerbuild
|
|
```
|
|
|
|
### Use a specific builder instance (--builder) {#builder}
|
|
|
|
```console
|
|
docker buildx history export --builder builder0 ^1 -o builder0-build.dockerbuild
|
|
```
|
|
|
|
### Enable debug logging (--debug) {#debug}
|
|
|
|
```console
|
|
docker buildx history export --debug qu2gsuo8ejqrwdfii23xkkckt -o debug-build.dockerbuild
|
|
```
|
|
|
|
### Ensure build records are finalized before exporting (--finalize) {#finalize}
|
|
|
|
Clients can report their own traces concurrently, and not all traces may be
|
|
saved yet by the time of the export. Use the `--finalize` flag to ensure all
|
|
traces are finalized before exporting.
|
|
|
|
```console
|
|
docker buildx history export --finalize qu2gsuo8ejqrwdfii23xkkckt -o finalized-build.dockerbuild
|
|
```
|
|
|
|
### Export a single build to a custom file (--output) {#output}
|
|
|
|
```console
|
|
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt --output mybuild.dockerbuild
|
|
```
|
|
|
|
You can find build IDs by running:
|
|
|
|
```console
|
|
docker buildx history ls
|
|
```
|
|
|
|
To export two builds to separate files:
|
|
|
|
```console
|
|
# Using build IDs
|
|
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3 -o multi.dockerbuild
|
|
|
|
# Or using relative offsets
|
|
docker buildx history export ^1 ^2 -o multi.dockerbuild
|
|
```
|
|
|
|
Or use shell redirection:
|
|
|
|
```console
|
|
docker buildx history export ^1 > mybuild.dockerbuild
|
|
docker buildx history export ^2 > backend-build.dockerbuild
|
|
```
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|