Formations — 1 037 leçons en français

Accueil › Node.js › Une image de conteneur correcte

Une image de conteneur correcte

Déploiementavance

Une image de conteneur Node correcte tient en six décisions. Les voici dans l'ordre où elles apparaissent dans le fichier de construction.

# --- étape 1 : installer et construire ---
FROM node:22-slim AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build

# --- étape 2 : l'image livrée ---
FROM node:22-slim
ENV NODE_ENV=production
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --omit=dev && npm cache clean --force
COPY --from=build /app/dist ./dist
USER node
CMD ["node", "dist/index.js"]

Le verrou avant le code. COPY package*.json précède COPY . . pour que la couche d'installation survive à une modification du code. Inversez les deux lignes et chaque correction d'une virgule relance npm ci.

npm ci, pas npm install. ci installe exactement ce que décrit le verrou, et échoue si le verrou et package.json divergent. C'est la seule commande qui garantit que vous livrez les versions que vous avez testées.

Deux étapes. Les outils de construction restent dans la première. L'image livrée ne contient ni compilateur, ni cadre de test, ni les quelques centaines de mégaoctets qui vont avec.

--omit=dev. Chaque dépendance de développement absente est une faille potentielle absente.

USER node. L'image officielle fournit cet utilisateur. Sans cette ligne, le processus tourne en root, et une exécution de code arbitraire devient un accès root à tout le conteneur.

La forme en tableau pour CMD. Elle met Node en processus numéro un, sans shell intermédiaire. C'est la condition pour que SIGTERM arrive dans votre code, donc pour que l'arrêt propre du chapitre 1 serve à quelque chose.

Les termes à connaître

Construction en plusieurs étapes

Une première étape installe tout et compile, une seconde ne garde que le résultat. Seule la dernière étape devient l'image livrée.

Dépendances de production

npm ci --omit=dev n'installe pas les outils de test et de construction. Ils n'ont rien à faire dans l'image qui tourne.

Cache de couches

Chaque instruction du fichier de construction produit une couche. Une couche est réutilisée tant que ce qu'elle copie n'a pas changé.

Verrou de dépendances

package-lock.json. Copié avant le code pour que l'installation soit mise en cache indépendamment des modifications de vos fichiers.

Utilisateur non privilégié

Un conteneur tourne en root par défaut. Une faille d'exécution de code devient alors une faille root sur le système de fichiers du conteneur.

Processus numéro un

Le premier processus d'un conteneur. Il ne reçoit pas les signaux par défaut comme un processus ordinaire : il faut les gérer explicitement.

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.