Accueil › Docker & conteneurs › Le montage de secret de BuildKit
Le montage de secret de BuildKit
Configuration et secretsintermediaire
Quand une construction a réellement besoin d'un secret — un jeton pour un dépôt de paquets interne, une clé de miroir — la réponse n'est pas de le faire entrer dans l'image par un argument ou un fichier copié. C'est le montage de secret de BuildKit.
RUN --mount=type=secret,id=jeton_npm \
npm config set //registre.interne/:_authToken \
"$(cat /run/secrets/jeton_npm)" \
&& npm ci --omit=dev \
&& npm config delete //registre.interne/:_authToken
Le fichier existe pendant cette instruction seulement. Il n'appartient à aucune couche. L'historique n'enregistre que le texte de l'instruction, qui contient un identifiant et un chemin — pas la valeur.
Fournir le secret à la construction
docker build --secret id=jeton_npm,src=./jeton.txt -t mon-api:1.4.2 .
Le secret peut aussi venir de l'environnement du shell appelant plutôt que d'un fichier. L'identifiant déclaré dans la recette et celui fourni à la commande doivent concorder, sinon la construction échoue au moment d'exécuter l'instruction.
Une condition facile à perdre
L'écriture du jeton dans le fichier de configuration et sa suppression doivent
rester dans la même instruction. Découpée en deux lignes RUN, la
configuration est écrite dans une couche, et le montage n'y change plus rien.
Les termes à connaître
- Montage de secret
Un fichier rendu disponible à une seule instruction de construction, sous un chemin temporaire, sans être écrit dans aucune couche ni dans l'historique.
- BuildKit
Le constructeur utilisé par défaut. C'est lui qui fournit les montages de secret, de cache et de fichiers temporaires.
- Identifiant de secret
Le nom qui relie le secret demandé dans la recette au secret fourni à la commande de construction. Les deux doivent concorder.
- Cible de montage
Le chemin où le fichier apparaît pendant l'instruction. Il existe le temps de la commande et disparaît ensuite.
- Clé d'empreinte du cache
Ce que le constructeur compare pour réutiliser une étape. Le contenu d'un secret monté n'en fait pas partie, ce qui a des conséquences.
- Montage de cache
Un répertoire conservé entre constructions, hors des couches. Il accélère les installations sans alourdir l'image.
- Secret de construction
Un secret nécessaire pendant la fabrication de l'image — jeton de dépôt privé, clé de miroir — et jamais nécessaire à l'exécution.
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.