Cache Amazon S3

Table des matières

Availability: Experimental

Le stockage de cache s3 téléverse votre cache de construction résultant vers le service de stockage de fichiers Amazon S3 ou d'autres services compatibles S3, comme MinIO.

Ce backend de stockage de cache n'est pas pris en charge avec le pilote docker par défaut. Pour utiliser cette fonctionnalité, créez un nouveau constructeur en utilisant un pilote différent. Voir Pilotes de construction pour plus d'informations.

Synopsis

$ docker buildx build --push -t <user>/<image> \
  --cache-to type=s3,region=<region>,bucket=<bucket>,name=<cache-image>[,parameters...] \
  --cache-from type=s3,region=<region>,bucket=<bucket>,name=<cache-image> .

Le tableau suivant décrit les paramètres CSV disponibles que vous pouvez passer à --cache-to et --cache-from.

Nom	Option	Type	Par défaut	Description
`region`	`cache-to`,`cache-from`	Chaîne		Obligatoire. Emplacement géographique.
`bucket`	`cache-to`,`cache-from`	Chaîne		Obligatoire. Nom du bucket S3.
`name`	`cache-to`,`cache-from`	Chaîne		Nom de l'image de cache.
`endpoint_url`	`cache-to`,`cache-from`	Chaîne		Point de terminaison du bucket S3.
`blobs_prefix`	`cache-to`,`cache-from`	Chaîne		Préfixe à ajouter aux noms de fichiers blob.
`upload_parallelism`	`cache-to`	Entier	`4`	Nombre de téléversements de couches parallèles.
`touch_refresh`	`cache-to`	Durée	`24h`	Intervalle pour mettre à jour l'horodatage des couches de cache inchangées.
`manifests_prefix`	`cache-to`,`cache-from`	Chaîne		Préfixe à ajouter aux noms de fichiers manifestes.
`use_path_style`	`cache-to`,`cache-from`	Booléen	`false`	Quand `true`, utilise `bucket` dans l'URL au lieu du nom d'hôte.
`access_key_id`	`cache-to`,`cache-from`	Chaîne		Voir authentification.
`secret_access_key`	`cache-to`,`cache-from`	Chaîne		Voir authentification.
`session_token`	`cache-to`,`cache-from`	Chaîne		Voir authentification.
`mode`	`cache-to`	`min`,`max`	`min`	Couches de cache à exporter, voir mode de cache.
`ignore-error`	`cache-to`	Booléen	`false`	Ignorer les erreurs causées par les exportations de cache échouées.

Authentification

Buildx peut réutiliser les identifiants AWS existants, configurés soit à l'aide d'un fichier d'identifiants, soit à l'aide de variables d'environnement, pour pousser et tirer le cache vers S3. Alternativement, vous pouvez utiliser les attributs access_key_id, secret_access_key et session_token pour spécifier les identifiants directement sur la ligne de commande.

Référez-vous à AWS Go SDK, Spécifier les identifiants pour plus de détails sur l'authentification à l'aide de variables d'environnement et de fichiers d'identifiants.

Pour aller plus loin

Pour une introduction à la mise en cache, voir Cache de construction Docker.

Pour plus d'informations sur le backend de cache s3, voir le README de BuildKit.