Aller au contenu principal

1.11 Dockerfile : démarrer un process avec des arguments

Objectifs pédagogiques​

  • Savoir lancer un process dans un container Docker
  • Savoir utiliser les commandes CMD, ENTRYPOINT

CMD, ENTRYPOINT et leur combinaison​

Instruction CMD​

CMD ["executable","param1","param2"] (exec form, this is the preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (shell form)

Généralement à la fin du Dockerfile : elle permet de préciser la commande par défaut lancée à la création d'une instance du conteneur avec docker run. on l'utilise avec une liste de paramètres

CMD ["echo 'Conteneur démarré'"]

Instruction ENTRYPOINT​

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

Précise le programme de base (le "prompt") avec lequel sera lancé la commande

FROM python:3.9
ENTRYPOINT ["/usr/bin/python3"]

Ensuite on peut faire : docker run python_entrypoint -c 'print("hello")

Attention CMD != ENTRYPOINT != RUN​

Ne surtout pas confondre avec RUN qui exécute une commande Bash uniquement pendant la construction de l'image.

CMD et ENTRYPOINT sont plus apparentés mais il faut également bien faire la distinction

Combinaisons de ENTRYP0INT et CMD - Comment s'y retrouver ?!​

En général il y a 9 combinaisons possibles des deux commandes => les résultats sont compliqués et peu intuitifs: la doc

En réalité on utilise que 3 situations en général

Cas 1 - la plupart du temps ENTRYPOINT est facultatif et on utilise que CMD​

Quand il n'y a que CMD dans le Dockerfile :

  • soit on fait docker run sans donner de commande et c'est le CMD du Dockerfile qui prime
  • soit on donne une commande et elle écrase le CMD du Dockerfile

La plupart des cas de commandes docker run que nous avons vu jusqu'ici rentrent dans cette catégorie

Cas 2 - ENTRYPOINT type ["/usr/bin/python3"]​

On utilise ce cas quand on veut créer un conteneur "outil" basé sur un programme "prompt" de base. Exemple donné plus haut:

FROM python:3.9
ENTRYPOINT ["/usr/bin/python3"]

Ensuite on peut faire : docker run python_entrypoint -c 'print("hello") dans ce cas :

  • -c et print("hello") sont ajoutés comme arguments de l'entrypoint /usr/bin/python3
  • nous avons un conteneur "outil" qui permet lancer un bout de code python directement.
  • si on ne précise pas de commande avec Docker run c'est juste /usr/bin/python3 sans argument qui est exécuté.

Vois aussi cowsay plus bas comme outils pour décorer du texte avec Docker. On pourrait imaginer d'autres outils par exemple utiliser /usr/bin/nslookup pour faire des check dns directement sans entrer dans un conteneur. etc

Cas 3 - ENTRYPOINT type ["/usr/bin/python3"] + une CMD​

FROM python:3.9
ENTRYPOINT ["/usr/bin/python3"]
CMD ['-c', 'print("je peux executer du python directement")']

Dans ce cas :

  • si on ne donne pas de commande à docker run le conteneur execute /usr/bin/python3 -c 'print("je peux executer du python directement")'
  • si on donne une commande à docker run elle remplace la partie CMD mais pas l'entrypoint. Par exemple docker run python_entrypoint -c 1+1 affiche 2 (car [-c,print(... directement)] de la CMD on été remplacés par les nouveaux arguments)

=> on a une sorte d'"outil" rapide comme le cas 2 mais il a une valeur par défaut pour ses arguments qu'on peut surcharger

Facultatif : Faire parler la vache​

Créons un nouveau Dockerfile qui permet de faire dire des choses à une vache grâce à la commande cowsay.

FROM ubuntu
RUN apt-get update && apt-get install -y cowsay
ENTRYPOINT ["/usr/games/cowsay"]

Le but est de faire fonctionner notre programme dans un conteneur à partir de commandes de type :

  • docker run --rm cowsay Coucou !

  • docker run --rm cowsay -f stegosaurus Yo!

  • docker run --rm cowsay -f elephant-in-snake Un éléphant dans un boa.

  • Doit-on utiliser la commande ENTRYPOINT ou la commande CMD ? Se référer au manuel de référence sur les Dockerfiles si besoin.

  • Pour information, cowsay s'installe dans /usr/games/cowsay.

  • La liste des options (incontournables) de cowsay se trouve ici : https://debian-facile.org/doc:jeux:cowsay

L'instruction ENTRYPOINT et la gestion des entrées-sorties des programmes dans les Dockerfiles peut être un peu capricieuse et il faut parfois avoir de bonnes notions de Bash et de Linux pour comprendre (et bien lire la documentation Docker).