Formations — 1 037 leçons en français

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.

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.