Exportateurs OCI et Docker

Table des matières

L'exportateur oci exporte le résultat de build dans une archive tar OCI image layout. L'exportateur docker se comporte de la même manière, sauf qu'il exporte une disposition d'image Docker à la place.

Le driver docker ne prend pas en charge ces exportateurs. Vous devez utiliser docker-container ou un autre driver si vous voulez générer ces sorties.

Synopsis

Construire une image de conteneur en utilisant les exportateurs oci et docker :

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

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

Le tableau suivant décrit les paramètres disponibles :

Paramètre	Type	Défaut	Description
`name`	String		Spécifier le(s) nom(s) d'image
`dest`	String		Chemin
`tar`	`true`,`false`	`true`	Emballer la sortie dans une disposition tarball
`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
`oci-mediatypes`	`true`,`false`		Utiliser les types de média OCI dans les manifestes d'exportateur. Par défaut `true` pour `type=oci`, et `false` pour `type=docker`. Voir Types de média OCI
`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 oci ou docker, voir le README BuildKit.