⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Exportateurs Image et registry

Table des matières

L'exportateur image exporte le résultat de build dans un format d'image de conteneur. L'exportateur registry est identique, mais il pousse automatiquement le résultat en définissant push=true.

Synopsis

Construire une image de conteneur en utilisant les exportateurs image et registry :

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

Le tableau suivant décrit les paramètres disponibles que vous pouvez passer à --output pour type=image :

Paramètre Type Défaut Description
name String Spécifier le(s) nom(s) d'image
push true,false false Pousser après avoir créé l'image.
push-by-digest true,false false Pousser l'image sans nom.
registry.insecure true,false false Permettre la poussée vers un registre non sécurisé.
dangling-name-prefix <value> Nommer l'image avec prefix@<digest>, utilisé pour les images anonymes
name-canonical true,false Ajouter un nom canonique supplémentaire name@<digest>
compression uncompressed,gzip,estargz,zstd gzip Type de compression, voir compression
compression-level 0..22 Niveau de compression, voir compression
force-compression true,false false Appliquer forcément la compression, voir compression
rewrite-timestamp true,false false Réécrire les horodatages de fichier à la valeur SOURCE_DATE_EPOCH. Voir reproductibilité de build pour comment spécifier la valeur SOURCE_DATE_EPOCH.
oci-mediatypes true,false false Utiliser les types de média OCI dans les manifestes d'exportateur, voir Types de média OCI
oci-artifact true,false false Les attestations sont formatées comme des artefacts OCI, voir Types de média OCI
unpack true,false false Déballer l'image après création (pour utilisation avec containerd)
store true,false true Stocker les images résultantes dans le magasin d'images du worker (par exemple, containerd), et s'assurer que l'image a tous les blobs dans le magasin de contenu. Ignoré si le worker n'a pas de magasin d'images (lors de l'utilisation de workers OCI, par exemple).
annotation.<key> String Attacher une annotation avec la key et value respectives à l'image construite, voir annotations

Annotations

Ces exportateurs prennent en charge l'ajout d'annotation OCI en utilisant le paramètre annotation, suivi du nom de l'annotation en utilisant la notation par points. L'exemple suivant définit l'annotation org.opencontainers.image.title :

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

Pour plus d'informations sur les annotations, voir la documentation BuildKit.

Lecture complémentaire

Pour plus d'informations sur les exportateurs image ou registry, voir le README BuildKit.