Les commandes Docker essentielles : run, ps, logs, exec

Les commandes Docker de base servent à lancer un conteneur à partir d'une image (docker run), à voir ce qui tourne (docker ps), à lire ses journaux (docker logs), à entrer dedans (docker exec) et à l'arrêter ou le supprimer (docker stop, docker rm). Ce chapitre les pratique sur un serveur web et une base de données de test, explique le cycle de vie d'un conteneur et les politiques de redémarrage, puis montre comment faire le ménage.

Lancer un conteneur avec docker run

docker run télécharge l'image si elle manque, crée un conteneur et le démarre. Lance un serveur web Nginx :

docker run -d --name web -p 8080:80 nginx:1.30-alpine

Vérifie depuis l'hôte :

curl -I http://localhost:8080

HTTP/1.1 200 OK
Server: nginx/1.30.4
Content-Type: text/html

Les options de docker run que tu utiliseras le plus :

Voir les conteneurs : docker ps

docker ps

CONTAINER ID   IMAGE               COMMAND                  CREATED          STATUS          PORTS                                     NAMES
3f2a9c1e7b4d   nginx:1.30-alpine   "/docker-entrypoint.…"   12 seconds ago   Up 11 seconds   0.0.0.0:8080->80/tcp, [::]:8080->80/tcp   web

docker ps n'affiche que les conteneurs en cours d'exécution ; docker ps -a montre aussi ceux qui sont arrêtés, avec leur code de sortie (Exited (0) 3 minutes ago). La colonne PORTS indique que le port 8080 est publié sur toutes les adresses IPv4 (0.0.0.0) et IPv6 ([::]) de l'hôte.

Pour un affichage plus lisible, choisis les colonnes :

docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

Le cycle de vie d'un conteneur

Un conteneur passe par plusieurs états. docker run enchaîne docker create (le conteneur existe, état created) et docker start (état running).

Le code de sortie affiché par docker ps -a aide au diagnostic : 0 pour un arrêt normal, 1 pour une erreur de l'application, 128 + n pour un arrêt par le signal numéro n. 137 (128 + 9) signale donc un SIGKILL : un docker kill, un docker stop qui a dû forcer, ou le noyau qui a tué le processus faute de mémoire. 143 (128 + 15) signale un SIGTERM que l'application n'a pas intercepté.

Les politiques de redémarrage

L'option --restart dit au démon quoi faire quand le conteneur s'arrête :

Pour un service sur un serveur, unless-stopped est le choix courant : le service survit à un redémarrage de srv-gestion, mais un technicien qui l'arrête pour une maintenance n'a pas la surprise de le voir revenir.

Lire les journaux : docker logs

Un conteneur bien conçu écrit ses journaux sur sa sortie standard et sa sortie d'erreur ; Docker les capture.

docker logs web                # tout
docker logs --tail 20 web      # les 20 dernières lignes
docker logs -f web             # en continu (Ctrl+C pour sortir)
docker logs --since 10m web    # les 10 dernières minutes

172.17.0.1 - - [03/Nov/2026:09:31:02 +0000] "HEAD / HTTP/1.1" 200 0 "-" "curl/8.14.1" "-"

L'adresse 172.17.0.1 est celle de l'hôte sur le réseau par défaut de Docker : la requête de curl est passée par la publication de port. Le chapitre 10 explique comment conserver et centraliser ces journaux.

Entrer dans un conteneur : docker exec

docker exec lance une commande dans un conteneur qui tourne déjà (à ne pas confondre avec docker run, qui en crée un nouveau) :

docker exec web nginx -t          # tester la configuration de Nginx
docker exec -it web sh            # ouvrir un shell (Ctrl+D pour sortir)

Les images Alpine n'ont que sh ; les images Debian ont bash. Certaines images minimales n'ont aucun shell : c'est volontaire (chapitre 5).

Inspecter et mesurer

docker stats --no-stream

CONTAINER ID   NAME   CPU %     MEM USAGE / LIMIT     MEM %     NET I/O         BLOCK I/O    PIDS
3f2a9c1e7b4d   web    0.00%     9.1MiB / 3.82GiB      0.23%     1.2kB / 1.1kB   0B / 4.1kB   3

La limite affichée, 3,82 Gio, est toute la mémoire de la VM : sans --memory, le conteneur peut tout prendre.

Une base de données de test en une commande

Les variables d'environnement configurent une image au lancement. L'image officielle MySQL lit, entre autres, MYSQL_ROOT_PASSWORD :

docker run -d --name bdd-test \
  -e MYSQL_ROOT_PASSWORD='Test-Labo-2026!' \
  -p 127.0.0.1:3306:3306 \
  mysql:8.4

Le port n'est publié que sur 127.0.0.1 : la base est joignable depuis srv-gestion, pas depuis le réseau. Attends une dizaine de secondes l'initialisation, puis connecte-toi avec le client inclus dans l'image :

docker logs bdd-test 2>&1 | grep 'ready for connections'
docker exec -it bdd-test mysql -uroot -p

Les exercices du cours SQL se font très bien dans un tel conteneur.

Faire le ménage

Les conteneurs arrêtés, les images inutilisées et les volumes orphelins s'accumulent.

Exercices

docker run -d --name wiki \
  -p 192.168.10.179:8090:80 \
  -e TZ=Europe/Paris \
  --restart unless-stopped \
  nginx:1.30-alpine

NAMES        STATUS
import-csv   Exited (0) 2 hours ago
api-frais    Exited (137) 5 minutes ago
worker       Exited (1) 1 minute ago

docker exec web nginx -t