docker ps
100%

Docker · Leçon 4

docker ps

Apprenez à lister les conteneurs Docker et à distinguer ceux qui tournent de ceux qui se sont arrêtés.

Le serveur web que vous avez démarré dans Docker tourne-t-il toujours ? Vérifiez avec docker ps. Une image Docker contient le programme et les fichiers dont il a besoin. Un conteneur est une instance créée à partir de cette image. La commande affiche la liste des conteneurs au moment où vous l’exécutez.

Lister les conteneurs qui tournent

Par défaut, docker ps liste les conteneurs en cours d’exécution. Les exemples montrent quelques colonnes d’un environnement Docker préparé. Vous pouvez les lire sans installer Docker. Dans le terminal, tapez la commande qui suit l’invite $.

$ docker ps
IMAGE         STATUS         NAMES
nginx:alpine  Up 4 minutes   web
nginx:alpine  Up 30 seconds  demo

Si Docker n’affiche que les en-têtes de colonnes, la liste des conteneurs en cours d’exécution est vide. L’environnement peut encore contenir des conteneurs arrêtés.

Après docker ps, Docker n’affiche que les en-têtes de colonnes. Que pouvez-vous en déduire ?

Lire les noms et les états

Commencez par chercher le conteneur dans la colonne NAMES. Les deux lignes affichent la même image, nginx:alpine, dans la colonne IMAGE. Repérez web à droite, puis lisez STATUS sur la même ligne. Up 4 minutes signifie que ce conteneur tourne depuis environ quatre minutes.

Quelle ligne correspond à un conteneur qui tourne depuis une trentaine de secondes ?

Inclure les conteneurs arrêtés

Si un conteneur attendu ne figure pas dans la liste, essayez docker ps -a. L’option -a est la forme courte de --all. Elle inclut les conteneurs qui se sont arrêtés mais existent encore. L’exemple présente aussi une tâche préparée nommée preview.

$ docker ps -a
IMAGE         STATUS                         NAMES
nginx:alpine  Up 4 minutes                   web
nginx:alpine  Up 30 seconds                  demo
busybox:1.36  Exited (0) 2 minutes ago       report
busybox:1.36  Exited (1) About a minute ago  preview

Un conteneur exécute un programme principal, par exemple un serveur web ou un script. Exited signifie que ce programme s’est arrêté. Le nombre entre parenthèses est son code de sortie, le résultat indiqué en fin d’exécution. Zéro indique généralement une réussite et une autre valeur signale le plus souvent une erreur. La tâche report affiche Exited (0), ce qui est normal pour une tâche terminée avec succès.

Terminal LabEx montrant des conteneurs en cours d’exécution et arrêtés, report avec le code de sortie 0 et preview avec le code 1

La capture LabEx n’affiche que les noms et les états des quatre conteneurs de l’exemple. Les durées varient selon le moment où la commande est exécutée.

Sur quelle ligne chercheriez-vous une erreur, d’après le code de sortie ?

Choisir la prochaine vérification

Le code de sortie vous aide à savoir quoi regarder. Pour vérifier si preview a écrit un message d’erreur, donnez son nom à docker logs. La commande affiche la sortie que Docker a recueillie pour ce conteneur.

$ docker logs preview

Si un serveur web tourne, vous pouvez aussi vérifier qu’un visiteur arrive à ouvrir sa page. Ouvrez-la depuis la machine qui doit y accéder. Up décrit l’état du programme dans le conteneur. Une requête réussie du navigateur confirme que la page est accessible depuis la machine de test.

La page s’ouvre sur la machine qui exécute Docker. Une autre personne doit l’ouvrir depuis son poste. Quel test vous permettra de savoir si elle y accède ?

Leçon terminée

Vous avez terminé docker ps

Vous savez maintenant utiliser la liste des conteneurs pour en trouver un, lire son état et choisir quoi vérifier ensuite.

  • Utiliser docker ps pour lister les conteneurs qui tournent.

  • Retrouver un conteneur par son nom et lire son état.

  • Utiliser docker ps -a pour inclure les conteneurs arrêtés.

  • Consulter les journaux ou envoyer une requête avec le navigateur quand l’état ne suffit pas.

Conservez votre progression

Créez un compte gratuit pour enregistrer cette leçon et continuer sur n'importe quel appareil.

Créer un compte gratuit
Leçon Suivante
Retour à Docker