Répertorier les conteneurs dans Docker

Utilisez l’interface en ligne de commande Docker pour répertorier les conteneurs, puis choisissez les options selon que vous voulez afficher les conteneurs en cours d’exécution, ceux qui sont arrêtés, un nombre limité de résultats ou des champs précis. Ces commandes interrogent le démon Docker sélectionné par votre contexte actuel. Les exemples ci-dessous présentent la syntaxe des commandes. Les résultats dépendent des conteneurs présents sur ce démon ; aucun résultat fixe n’est donc affiché.

Répertorier tous les conteneurs en cours d’exécution dans Docker

Exécutez docker ps pour répertorier les conteneurs actuellement en cours d’exécution. La commande équivalente est docker container ls :

docker ps

Le tableau par défaut comprend l’identifiant du conteneur, l’image, la commande de démarrage, l’ancienneté de création, l’état, les ports publiés ou exposés et le nom. Le champ STATUS indique depuis combien de temps un conteneur est en cours d’exécution. Les entrées de ports décrivent des mappages ou des ports exposés ; à elles seules, elles ne permettent pas de savoir si un service est accessible depuis votre machine.

Utilisez docker container ls si vous préférez la forme avec le groupe de commandes. Cette commande renvoie le même ensemble par défaut et les mêmes colonnes que docker ps.

Répertorier les conteneurs en cours d’exécution et arrêtés dans Docker

Ajoutez -a (ou --all) pour inclure les conteneurs arrêtés en plus de ceux qui sont en cours d’exécution :

docker ps -a

Un conteneur arrêté reste répertorié avec un état tel que Exited (0), où le nombre correspond à son code de sortie. L’état des conteneurs en cours d’exécution commence par Up. Cette option modifie les états inclus ; elle ne démarre pas les conteneurs arrêtés. Si le démon ne contient aucun conteneur, le tableau n’affiche que son en-tête.

Répertorier un nombre précis de conteneurs dans Docker

Utilisez -n avec un nombre pour afficher au maximum ce nombre de conteneurs créés le plus récemment, quel que soit leur état. Par exemple, docker container ls -n 2 renvoie au maximum deux conteneurs ; avec cette option, vous n’avez pas besoin de -a pour inclure les conteneurs arrêtés. Ce nombre est une limite : moins de lignes peuvent apparaître s’il existe moins de conteneurs. Pour limiter spécifiquement les conteneurs ayant quitté leur exécution, associez cette limite à --filter "status=exited", par exemple docker ps -n 2 --filter "status=exited".

Répertorier uniquement les conteneurs arrêtés dans Docker

Filtrez par état pour trouver les conteneurs arrêtés dont l’état enregistré est « exited » :

docker container ls -a --filter "status=exited"

L’option -a inclut les conteneurs qui ne sont pas en cours d’exécution dans l’ensemble examiné ; le filtre d’état sélectionne ensuite ceux dont l’état est « exited ». Ce filtre n’inclut pas les autres états d’arrêt. Les filtres Docker peuvent être combinés ; chaque condition doit correspondre aux résultats recherchés.

Répertorier les conteneurs créés récemment dans Docker

Utilisez --latest (ou -l) pour afficher le conteneur créé le plus récemment :

docker container ls --latest

Cette option est utile pour récupérer l’entrée du conteneur le plus récent, y compris s’il est arrêté. Elle ne demande pas plusieurs conteneurs récents ; utilisez -n pour en indiquer le nombre. Pour rechercher le plus récent parmi tous les états, docker ps -a --latest rend explicite l’inclusion de tous les états.

Répertorier les identifiants des conteneurs dans Docker

Ajoutez -q (ou --quiet) pour afficher uniquement les identifiants des conteneurs :

docker container ls -q

Ce format compact est pratique pour transmettre les identifiants affichés à une autre commande ou les enregistrer dans une variable shell. Par défaut, la commande répertorie toujours les conteneurs en cours d’exécution ; ajoutez -a pour inclure les conteneurs arrêtés. La sortie silencieuse omet les noms, les états et les autres champs du tableau ; utilisez donc l’affichage normal si vous devez examiner ces détails.

Afficher la taille des conteneurs dans Docker

Ajoutez -s (ou --size) pour inclure des informations de taille dans la liste :

docker container ls -s

La colonne SIZE indique la taille de la couche inscriptible du conteneur et sa taille virtuelle. La taille de la couche inscriptible correspond aux modifications apportées dans ce conteneur ; la taille virtuelle tient également compte des couches de l’image qu’il utilise. Ces valeurs décrivent l’espace de stockage, pas la mémoire actuellement consommée. Pour connaître l’utilisation de la mémoire vive, utilisez une commande ou un outil de supervision. Comme la liste par défaut, cette commande affiche les conteneurs en cours d’exécution, sauf si vous ajoutez -a.