# Exportadores de imagen y de registro


El exportador `image` genera el resultado de la compilación en formato de imagen de contenedor. El exportador `registry` es idéntico, pero sube automáticamente el resultado al establecer `push=true`.

## Sinopsis

Compila una imagen de contenedor utilizando los exportadores `image` y `registry`:

```console
$ docker buildx build --output type=image[,parameters] .
$ docker buildx build --output type=registry[,parameters] .
```

La siguiente tabla describe los parámetros disponibles que puedes pasar a `--output` para `type=image`:

| Parámetro | Tipo | Predeterminado | Descripción |
| ---------------------- | -------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                 | String                                 |         | Especifica los nombres de las imágenes |
| `push`                 | `true`,`false`                         | `false` | Sube la imagen después de crearla. |
| `push-by-digest`       | `true`,`false`                         | `false` | Sube la imagen sin nombre. |
| `registry.insecure`    | `true`,`false`                         | `false` | Permite subir a un registro inseguro. |
| `dangling-name-prefix` | `<valor>`                              |         | Nombra la imagen con `prefix@<digest>`, utilizado para imágenes anónimas |
| `name-canonical`       | `true`,`false`                         |         | Añade un nombre canónico adicional `name@<digest>` |
| `compression`          | `uncompressed`,`gzip`,`estargz`,`zstd` | `gzip`  | Tipo de compresión, consulta [compresión][1] |
| `compression-level`    | `0..22`                                |         | Nivel de compresión, consulta [compresión][1] |
| `force-compression`    | `true`,`false`                         | `false` | Fuerza la aplicación de la compresión, consulta [compresión][1] |
| `rewrite-timestamp`    | `true`,`false`                         | `false` | Reestablece las marcas de tiempo de los archivos al valor de `SOURCE_DATE_EPOCH`. Consulta [reproducibilidad de compilación][4] para saber cómo especificar el valor de `SOURCE_DATE_EPOCH`. |
| `oci-mediatypes`       | `true`,`false`                         | `false` | Utiliza tipos de medio OCI en los manifiestos del exportador, consulta [Tipos de medio OCI][2] |
| `oci-artifact`         | `true`,`false`                         | `false` | Las atestaciones se formatean como artefactos OCI, consulta [Atestaciones como artefactos OCI][5] |
| `unpack`               | `true`,`false`                         | `false` | Desempaqueta la imagen después de la creación (para su uso con containerd) |
| `store`                | `true`,`false`                         | `true`  | Almacena las imágenes resultantes en el almacenamiento de imágenes del worker (por ejemplo, containerd) y garantiza que la imagen tenga todos los blobs en el almacén de contenido. Se ignora si el worker no tiene almacenamiento de imágenes (cuando se utilizan workers OCI, por ejemplo). |
| `annotation.<key>`     | String                                 |         | Adjunta una anotación con la respectiva clave y valor a la imagen compilada, consulta [anotaciones][3] |

[1]: /build/exporters/#compression
[2]: /build/exporters/#oci-media-types
[3]: #annotations
[4]: https://github.com/moby/buildkit/blob/master/docs/build-repro.md
[5]: /build/metadata/attestations/#attestations-as-oci-artifacts

## Anotaciones

Estos exportadores admiten añadir anotaciones OCI utilizando el parámetro `annotation`, seguido del nombre de la anotación usando la notación de punto. El siguiente ejemplo establece la anotación `org.opencontainers.image.title`:

```console
$ docker buildx build \
    --output "type=<type>,name=<registry>/<image>,annotation.org.opencontainers.image.title=<title>" .
```

Para obtener más información sobre las anotaciones, consulta la [documentación de BuildKit](https://github.com/moby/buildkit/blob/master/docs/annotations.md).

## Lectura adicional

Para obtener más información sobre los exportadores `image` o `registry`, consulta el [README de BuildKit](https://github.com/moby/buildkit/blob/master/README.md#imageregistry).