Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › CMD, ENTRYPOINT et la forme exec

CMD, ENTRYPOINT et la forme exec

Écrire un Dockerfiledebutant

Deux instructions décrivent le démarrage, et leur différence tient en une phrase : les arguments passés au lancement remplacent CMD et s'ajoutent à ENTRYPOINT.

Les trois combinaisons utiles

# 1. Commande par défaut, remplaçable en entier
CMD ["node", "serveur.js"]

# 2. Programme fixe, options par défaut
ENTRYPOINT ["node", "serveur.js"]
CMD ["--port", "3000"]

# 3. Script d'amorçage, qui finit par passer la main
ENTRYPOINT ["/usr/local/bin/entree.sh"]
CMD ["node", "serveur.js"]
Lancement Avec la combinaison 2
sans argument node serveur.js --port 3000
--port 8080 node serveur.js --port 8080

Forme exec et forme shell

CMD ["node", "serveur.js"]   # forme exec : node est le processus numéro un
CMD node serveur.js          # forme shell : un interpréteur est le numéro un

La seconde devient /bin/sh -c "node serveur.js". L'interpréteur prend le numéro un, l'application est son enfant.

La conséquence

Le signal d'arrêt est envoyé au processus numéro un. L'interpréteur ne le relaie pas. L'application ne le voit jamais, continue comme si de rien n'était, et le moteur la tue sans ménagement à la fin du délai de grâce : requêtes coupées, transactions laissées en plan.

Écrivez la forme en tableau. C'est la règle, pas une préférence.

Les termes à connaître

CMD

La commande par défaut du conteneur. Elle est entièrement remplacée par les arguments passés au lancement.

ENTRYPOINT

La commande fixe du conteneur. Les arguments passés au lancement viennent s'y ajouter au lieu de la remplacer.

Forme exec

L'écriture en tableau JSON. La commande est exécutée directement, sans interpréteur, et devient le processus numéro un.

Forme shell

L'écriture en texte libre. Le moteur l'exécute via un interpréteur, qui devient le processus numéro un à la place de l'application.

Processus numéro un

Le premier processus du conteneur. Il reçoit les signaux envoyés de l'extérieur, et le conteneur s'arrête quand il se termine.

Script d'amorçage

Un petit script placé en point d'entrée pour préparer l'environnement, et qui termine par exec sur la commande réelle.

Remplacement par exec

Le mot-clé qui remplace l'interpréteur par la commande, au lieu d'en lancer un enfant. Le numéro un devient l'application.

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.