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=devn'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.
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.