mirror of
https://gitea.com/Lydanne/buildx.git
synced 2025-05-18 00:47:48 +08:00
81 lines
2.2 KiB
Markdown
81 lines
2.2 KiB
Markdown
# docker buildx history export
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Export a build into Docker Desktop bundle
|
|
|
|
### Options
|
|
|
|
| Name | Type | Default | Description |
|
|
|:-----------------|:---------|:--------|:-----------------------------------------|
|
|
| [`--all`](#all) | `bool` | | Export all records for the builder |
|
|
| [`--builder`](#builder) | `string` | | Override the configured builder instance |
|
|
| `-D`, `--debug` | `bool` | | Enable debug logging |
|
|
| [`-o`](#o), [`--output`](#output) | `string` | | Output file path |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|
|
## Description
|
|
|
|
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.
|
|
|
|
## Examples
|
|
|
|
### <a name="output"></a> Export a single build to a custom file (--output)
|
|
|
|
```console
|
|
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt --output mybuild.dockerbuild
|
|
```
|
|
|
|
You can find build IDs by running:
|
|
|
|
```console
|
|
docker buildx history ls
|
|
```
|
|
|
|
### <a name="o"></a> Export multiple builds to individual `.dockerbuild` files (-o)
|
|
|
|
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
|
|
```
|
|
|
|
### <a name="all"></a> Export all build records to a file (--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
|
|
```
|
|
|
|
### <a name="builder"></a> Use a specific builder instance (--builder)
|
|
|
|
```console
|
|
docker buildx history export --builder builder0 ^1 -o builder0-build.dockerbuild
|
|
```
|
|
|
|
### <a name="debug"></a> Enable debug logging (--debug)
|
|
|
|
```console
|
|
docker buildx history export --debug qu2gsuo8ejqrwdfii23xkkckt -o debug-build.dockerbuild
|
|
``` |