Cache inline

Table des matières

Le backend de stockage de cache inline est le moyen le plus simple d'obtenir un cache externe et il est facile de commencer à l'utiliser si vous construisez et poussez déjà une image.

L'inconvénient du cache inline est qu'il ne s'adapte pas aussi bien aux constructions multi-étapes que les autres pilotes. Il n'offre pas non plus de séparation entre vos artefacts de sortie et votre sortie de cache. Cela signifie que si vous utilisez un flux de construction particulièrement complexe, ou que vous n'exportez pas vos images directement vers un registre, vous voudrez peut-être envisager le cache registry.

Synopsis

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=inline \
  --cache-from type=registry,ref=<registry>/<image> .

Aucun paramètre supplémentaire n'est pris en charge pour le cache inline.

Pour exporter le cache en utilisant le stockage inline, passez type=inline à l'option --cache-to :

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=inline .

Alternativement, vous pouvez également exporter le cache inline en définissant l'argument de construction BUILDKIT_INLINE_CACHE=1, au lieu d'utiliser l'indicateur --cache-to :

$ docker buildx build --push -t <registry>/<image> \
  --build-arg BUILDKIT_INLINE_CACHE=1 .

Pour importer le cache résultant lors d'une construction future, passez type=registry à --cache-from qui vous permet d'extraire le cache de l'intérieur d'une image Docker dans le registre spécifié :

$ docker buildx build --push -t <registry>/<image> \
  --cache-from type=registry,ref=<registry>/<image> .

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 inline, voir le README de BuildKit.