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:
$ 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 |
compression-level | 0..22 | Nivel de compresión, consulta compresión | |
force-compression | true,false | false | Fuerza la aplicación de la compresión, consulta compresión |
rewrite-timestamp | true,false | false | Reestablece las marcas de tiempo de los archivos al valor de SOURCE_DATE_EPOCH. Consulta reproducibilidad de compilación 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 |
oci-artifact | true,false | false | Las atestaciones se formatean como artefactos OCI, consulta Atestaciones como artefactos OCI |
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 |
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:
$ 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.
Lectura adicional
Para obtener más información sobre los exportadores image o registry, consulta el README de BuildKit.