Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Images multi-architectures

Images multi-architectures

Registre et publicationintermediaire

Une même étiquette fonctionne sur un poste à processeur ARM et sur un serveur x86 parce qu'elle ne désigne pas une image, mais un index de manifestes.

Ce que contient un index

Une liste d'entrées, chacune associant un manifeste à une plateforme :

mon-api:2.1.0  →  index
                  ├─ linux/amd64     → manifeste A
                  ├─ linux/arm64/v8  → manifeste B
                  └─ linux/arm/v7    → manifeste C

Au tirage, le moteur lit l'index, compare chaque entrée à sa propre plateforme, et ne télécharge que le manifeste retenu avec ses couches. Les autres ne traversent jamais le réseau.

La comparaison

Elle porte sur le système d'exploitation, l'architecture, et la variante lorsqu'elle est renseignée. Les trois doivent concorder. Une entrée windows/amd64 ne convient pas à un hôte linux/amd64, même si l'architecture correspond. Si aucune entrée ne convient, le tirage échoue — le moteur ne choisit pas au hasard.

Construire un index

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t registre.interne/equipe/api:2.1.0 \
  --push .

La publication directe est ici nécessaire : un index à plusieurs plateformes ne se range pas dans le stockage local d'un moteur mono-architecture.

Les termes à connaître

Index de manifestes

Un document qui référence plusieurs manifestes, un par plateforme, avec pour chacun sa description de plateforme. C'est lui que désigne l'étiquette d'une image multi-architecture.

Plateforme

Le couple système d'exploitation et architecture, parfois complété d'une variante. Elle s'écrit sous la forme linux/arm64/v8.

Variante

Une précision sur l'architecture, utile surtout pour les processeurs ARM. Elle distingue des générations incompatibles sous un même nom d'architecture.

Émulation

L'exécution d'instructions d'une architecture sur une autre, par traduction. Elle permet de construire pour une plateforme étrangère, au prix d'une lenteur importante.

Construction native

Une construction exécutée sur une machine de l'architecture visée. Plus rapide et plus fidèle que l'émulation, au prix d'un parc de machines à maintenir.

Empreinte d'index

L'empreinte de l'index lui-même, distincte de celle de chaque manifeste de plateforme. Les deux sont valides et ne désignent pas la même chose.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.