Les commandes de base de gestion des containers

1. La commande à lancer est

docker container run alpine echo hello

2. Le résultat de la commande précédente montre les différentes étapes qui sont effectuées:

Unable to find image 'alpine:latest' locally
latest: Pulling from library/alpine
88286f41530e: Pull complete
Digest: sha256:1072e499f3f655a032e88542330cf75b02e7bdf673278f701d7ba61629ee3ebe
Status: Downloaded newer image for alpine:latest
hello

L’image alpine n’étant pas disponible localement, elle est téléchargée depuis le Docker Hub. Un container est alors lancé à partir de cette image avec la commande spécifiée (echo “hello”). Le résultat de cette commande est affiché sur la sortie standard. Une fois la commande terminée, le container est stoppé mais il existe toujours.

3. La commande à lancer est “docker container run alpine”

L’image alpine étant déjà présente localement (téléchargée lors de l’étape précédente), elle est ré-utilisée. La commande exécutée par défaut lors du lancement d’un container basé sur alpine est “/bin/sh”. Cette commande ne produit pas de résultat sur la sortie standard. Une fois la commande terminée, le container est stoppé mais il existe toujours.

1. La commande permettant de lancer un container en mode “interactif” est la suivante:

docker container run -ti alpine

2. Nous obtenons un shell sh dans le container.

3. Par défaut, la commande par défaut utilisée dans l’image alpine est /bin/sh

Note: nous y reviendrons plus tard mais il est intéressant de voir que cette information est présente dans le fichier Dockerfile qui est utilisé pour créer l’image (https://github.com/gliderlabs/docker-alpine/blob/2127169e2d9dcbb7ae8c7eca599affd2d61b49a7/versions/library-3.6/x86_64/Dockerfile)

4. Nous pouvons naviguer dans le système de fichiers de la même façon que nous le faisons dans une autre distribution Linux plus “traditionnelle” en utilisant les commandes cd, ls, pwd, cat, less, …

5. Le gestionnaire de package d’une distribution alpine est apk

Pour mettre à jour la liste des packages, nous pouvons utiliser la commande apk update .

Pour installer un package, comme curl , nous utilisons la commande suivante apk add curl

1. Le container peut être lancé avec la commande suivante

docker container run alpine ping 8.8.8.8

2. La commande docker ps ne liste pas le container car le processus a été arrêté par la commande CTRL-C

3. La commande suivante permet de lancer le container en mode “interactif”

docker container run -ti alpine ping 8.8.8.8

4. La commande CTRL-P CTRL-Q permet de se détacher du pseudo terminal (alloué avec les options -t -i, ou -ti).

Le container continue à tourner. Il est listé avec la commande docker ps

5. La commande suivante permet de lancer le container en background

docker container run -d alpine ping 8.8.8.8

La commande docker ps permet de voir que le container tourne, il n’est simplement pas attaché au terminal depuis lequel il a été lancé.

1. La commande suivante permet de lancer le container basé sur nginx et d’exposer le port 80 de ce container sur le port 8080 de la machine hôte

docker container run -d -p 8080:80 nginx

2. La page index.html servie par défaut par nginx est accessible sur le port 8080

3. Si nous lançons un autre container en utilisant le même port de la machine hôte, nous obtenons une erreur car ce port ne peut pas être utilisé pour les 2 containers.

$ docker container run -d -p 8080:80 nginx
c9dc92128bd8871d1c75678fd41dc09c5afcf02857c7c64bd89f560cb2b6aec7
docker: Error response from daemon: driver failed programming external connectivity on endpoint objective_leakey (25ea6fe30398e51b5ad3dbd55a56cded518370c81a41d4013d58ca399647718a): Bind for 0.0.0.0:8080 failed: port is already allocated.

1. Pour lister les containers en cours d’execution sur le système, les 2 commandes suivantes sont équivalentes

• docker container ls
• docker ps

Note: la seconde commande est historique et date de l’époque ou la plateforme Docker était principalement utilisée pour la gestion des containers et des images. Par la suite, d’autres primitives que nous verrons dans les prochains chapitres ont été ajoutées (volume, network, node, …), ce qui a conduit à une refactorisation de l’api disponible en ligne de commande.

Seuls les containers en cours d’execution sont listés. Les containers qui ont été créés puis arrêtés ne sont pas visible dans la sortie de cette commande.

2. Les commandes suivantes permettent de lister les containers en cours d’execution ainsi que ceux qui sont stoppés.

docker container ls -a  et docker ps -a

3. Les commandes suivantes permettent de lister les identifiants de l’ensemble des containers tournant sur la machine hôte, ceux en cours d’execution et également ceux qui ont été stoppés.

• docker container ls -aq
• docker ps -aq

Note: on verra que ces commandes sont très utiles, notamment lorsque l’on souhaitera faire une action sur un ensemble de containers.

1. La commande permettant de lancer le container en question est la suivante

docker container run -d -p 8000:80 nginx:1.20

2. L’inspection d’un container se fait à l’aide de la commande docker inspect CONTAINER_ID

Note: il est possible de n’utiliser que les permiers caractères de l’identifiant, ou bien le nom du container si celui-ci à été précisé avec l’option –name lors de la création.

docker inspect 6ee

3. Les format de templating “Go template” permet de récupérer seulement les informations dont on a besoin dans cette imposante structure json.

La commande utilisée pour récupérer le nom du container:

$ docker inspect --format "{{ .Name }}" efc940
/elated_mclean

La commande pour récupérer l’adresse IP du container:

$ docker inspect -f '{{ .NetworkSettings.IPAddress }}' efc940
172.17.0.5

4. Le templating Go est très riche, vous trouverez quelques exemples supplémentaires à l’adresse suivante Go template

1. La commande suivante permet de lancer le container en question

$ docker container run -d --name ping alpine ping 8.8.8.8
172c401915f56e3fb10391259fac77bc2d3c194a1b27fa5072335e04656e57bb

2. La commande suivante permet de suivre les logs en continue (option -f) à partir de l’identifiant

$ docker container logs -f 172
PING 8.8.8.8 (8.8.8.8): 56 data bytes
64 bytes from 8.8.8.8: seq=0 ttl=37 time=20.713 ms
64 bytes from 8.8.8.8: seq=1 ttl=37 time=19.747 ms
64 bytes from 8.8.8.8: seq=2 ttl=37 time=19.730 ms
64 bytes from 8.8.8.8: seq=3 ttl=37 time=20.345 ms
64 bytes from 8.8.8.8: seq=4 ttl=37 time=24.476 ms

Le nom du container peut également être utilisé

$ docker container logs -f ping
...
64 bytes from 8.8.8.8: seq=162 ttl=37 time=20.364 ms
64 bytes from 8.8.8.8: seq=163 ttl=37 time=20.822 ms
64 bytes from 8.8.8.8: seq=164 ttl=37 time=22.478 ms
64 bytes from 8.8.8.8: seq=165 ttl=37 time=19.772 ms
64 bytes from 8.8.8.8: seq=166 ttl=37 time=19.630 ms

La commande CTRL-C permet de quitter la sortie de logs, mais elle ne stoppe pas le container car elle n’est pas envoyé au processus tournant dans celui-ci.

3. La commande suivante permet de lancer un shell sh dans le container

$ docker exec -ti ping sh
/ #

4. La commande suivante permet de lister les processus qui tournent dans le container

/ # ps aux
PID   USER     TIME   COMMAND
    1 root       0:00 ping 8.8.8.8
    7 root       0:00 sh
   13 root       0:00 ps aux

On peut voir que la commande avec laquelle le container a été lancé (ping 8.8.8.8 ) à le PID 1 (identifiant du processus). La commande sh que nous avons ensuite lancée dans le container à le PID 7 dans l’arbre de processus. Nous voyons également la commande ps aux qui a obtenue le PID 13, cette commande n’est plus active et si on la relance une nouvelle fois, on obtiendra un nouveau PID:

/ # ps aux
PID   USER     TIME   COMMAND
    1 root       0:00 ping 8.8.8.8
    7 root       0:00 sh
   14 root       0:00 ps aux

On peut sortir de notre shell avec un simple exit, le container continuera à tourner tant que le process de PID 1 est actif.

1. Afin de lister les containers qui tournent ainsi que ceux qui ont été arrêtés, il faut utiliser l’option -a , les commandes suivantes sont équivalentes:

docker ps -a

docker container ls -a

2. Pour stopper, en une seule ligne de commande, l’ensemble des containers qui tournent, on peut donner la liste des identifiants à la commande stop . On utilise pour cela l’option -q lorsque l’on liste les containers.

docker container stop $(docker container ls -q)  

3. La commande suivante ne devrait plus renvoyer de containers

docker container ls

Note: cette commande est équivalente à docker ps

4. Si on ajoute l’option -a , on obtient les containers qui sont arrêtés.

docker container ls -a

Note: cette commande est équivalente à docker ps -a

5. Pour supprimer les containers qui sont arrêtés, on procède de la même façon que dans la question 2, on donne la liste des identifiants à la commande rm.

docker container rm $(docker container ls -aq)

6. La commande suivante ne devrait plus lister aucun container

docker container ls -a