# docker buildx history export

**Descripción:** Exporta los registros de construcción a un paquete de Docker Desktop

**Uso:** `docker buildx history export [OPTIONS] [REF...]`










## Descripción

Exporta uno o más registros de construcción a archivos de archivo `.dockerbuild`.
Estos archivos contienen metadatos, registros (logs) y salidas de la construcción,
y se pueden importar a Docker Desktop o compartir entre diferentes entornos.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--all` |  |  Exporta todos los registros de construcción para el builder |

 | `--finalize` |  |  Asegura que los registros de construcción estén finalizados antes de exportar |

 | `-o`, `--output` |  |  Ruta del archivo de salida |




## Ejemplos

### Exportar todos los registros de construcción a un archivo (--all) {#all}

Utiliza la bandera `--all` y redirige la salida:

```console
docker buildx history export --all > all-builds.dockerbuild
```

O utiliza la bandera `--output`:

```console
docker buildx history export --all -o all-builds.dockerbuild
```

### Utilizar una instancia de builder específica (--builder) {#builder}

```console
docker buildx history export --builder builder0 ^1 -o builder0-build.dockerbuild
```

### Habilitar el registro de depuración (--debug) {#debug}

```console
docker buildx history export --debug qu2gsuo8ejqrwdfii23xkkckt -o debug-build.dockerbuild
```

### Asegurar que los registros de construcción estén finalizados antes de exportar (--finalize) {#finalize}

Los clientes pueden reportar sus propias trazas de forma concurrente, y es posible que no
todas las trazas se hayan guardado aún en el momento de la exportación. Utiliza la bandera
`--finalize` para asegurarte de que todas las trazas estén finalizadas antes de exportar.

```console
docker buildx history export --finalize qu2gsuo8ejqrwdfii23xkkckt -o finalized-build.dockerbuild
```

### Exportar una sola construcción a un archivo personalizado (--output) {#output}

```console
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt --output mybuild.dockerbuild
```

Puedes encontrar los ID de construcción ejecutando:

```console
docker buildx history ls
```

Para exportar dos construcciones a archivos separados:

```console
# Usando los ID de construcción
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3 -o multi.dockerbuild

# O usando desplazamientos relativos
docker buildx history export ^1 ^2 -o multi.dockerbuild
```

O usa la redirección del shell:

```console
docker buildx history export ^1 > mybuild.dockerbuild
```

```console
docker buildx history export ^2 > backend-build.dockerbuild
```