Chapitre 06
Docker sur l'edge : état & diagnostic

1. Le vocabulaire minimal

2. Voir ce qui tourne : docker ps

maint@edge-cell12:~$ docker ps
CONTAINER ID   IMAGE                       STATUS                    PORTS                    NAMES
b1f9a2c3d4e5   registry.local/edge:1.8.2   Up 87 days (healthy)      0.0.0.0:8080->8080/tcp   edge-gateway
7a2b1c9d8e6f   eclipse-mosquitto:2.0.18    Up 87 days                0.0.0.0:1883->1883/tcp   edge-mqtt

Chaque colonne dit quelque chose d'utile :

• IMAGE : registry.local/edge:1.8.2 — l'image et son tag. Le tag 1.8.2 est explicite ; méfie-toi d'un :latest (chapitre 7).
• STATUS : Up 87 days (healthy) — tourne depuis 87 jours et son healthcheck est vert. Restarting, Exited (1), unhealthy sont les états qui alertent.
• PORTS : 0.0.0.0:8080->8080/tcp — le port 8080 du conteneur est publié sur toutes les interfaces de l'edge.

maint@edge-cell12:~$ docker ps -a
CONTAINER ID   IMAGE                       STATUS                       NAMES
b1f9a2c3d4e5   registry.local/edge:1.8.2   Up 87 days (healthy)         edge-gateway
7a2b1c9d8e6f   eclipse-mosquitto:2.0.18    Exited (137) 4 minutes ago   edge-mqtt

3. Que dit le conteneur : docker logs

La sortie de l'application à l'intérieur du conteneur (que journald ne montre pas) se lit avec docker logs :

maint@edge-cell12:~$ docker logs --tail 20 -f edge-gateway
2026-07-04T08:24:01Z INFO  connected to opc.tcp://192.168.0.1:4840
2026-07-04T08:24:01Z INFO  subscribed 128 nodes, publish interval 1000ms
2026-07-04T08:24:02Z INFO  → mqtt localhost:1883 (128 tags)
^C

Les options utiles : --tail 20 (les 20 dernières lignes), -f (suivre en direct, comme journalctl -f), --since 10m (fenêtre temporelle), --timestamps (forcer l'horodatage).

4. Le healthcheck : sain ou malade ?

Un conteneur peut être Up (le processus tourne) tout en étant incapable de rendre son service (bloqué, déconnecté). Le healthcheck est une sonde définie dans l'image ou le compose qui teste périodiquement la santé applicative. On voit son verdict dans STATUS (healthy/unhealthy) et son détail avec inspect :

maint@edge-cell12:~$ docker inspect --format '{{json .State.Health}}' edge-gateway | python3 -m json.tool
{
    "Status": "healthy",
    "FailingStreak": 0,
    "Log": [
        { "ExitCode": 0, "Output": "OPC-UA up; MQTT up\n" }
    ]
}

5. Consommation : docker stats

maint@edge-cell12:~$ docker stats --no-stream
CONTAINER      CPU %   MEM USAGE / LIMIT   MEM %   NET I/O         BLOCK I/O
edge-gateway   3.2%    142MiB / 512MiB     27.7%   88MB / 44MB     12MB / 0B
edge-mqtt      0.8%    18MiB / 128MiB      14.1%   44MB / 88MB     2MB / 0B

--no-stream donne un instantané (sans lui, l'affichage se rafraîchit en continu). On surveille surtout la colonne MEM USAGE / LIMIT : un conteneur qui frôle sa limite mémoire est candidat à se faire tuer par le noyau (l'OOM kill du chapitre 4), avec un code de sortie 137.

6. Panne classique nº 1 : le restart loop

docker ps montre le conteneur en Restarting en boucle. La démarche :

maint@edge-cell12:~$ docker ps
CONTAINER ID   IMAGE                       STATUS                          NAMES
b1f9a2c3d4e5   registry.local/edge:1.8.2   Restarting (1) 8 seconds ago    edge-gateway

maint@edge-cell12:~$ docker logs --tail 5 edge-gateway
2026-07-04T09:01:14Z FATAL config file /cfg/gateway.yml: no such file or directory
maint@edge-cell12:~$ docker inspect --format '{{.State.ExitCode}} {{.RestartCount}}' edge-gateway
1 214

Lecture : le conteneur sort en erreur (ExitCode 1), la politique de redémarrage le relance, il replante — 214 fois. La cause est dans docker logs : un fichier de config manquant (un volume mal monté ? un chemin renommé ?). Le restart loop n'est pas la maladie, c'est le symptôme : on lit toujours la dernière erreur avant le redémarrage.

7. Réseaux & volumes en un coup d'œil

maint@edge-cell12:~$ docker volume ls
DRIVER    VOLUME NAME
local     edge_gateway-data      # ← les données à sauvegarder (ch. 8)
local     edge_mqtt-data

maint@edge-cell12:~$ docker network ls
NETWORK ID     NAME          DRIVER    SCOPE
3f1a...        edge_default  bridge    local
# Les conteneurs de la stack se parlent par leur nom sur ce réseau :
# edge-gateway atteint le broker via « edge-mqtt:1883 », pas via une IP.

8. Borner les logs Docker (place disque)

Par défaut, le pilote de logs json-file de Docker écrit sans limite : un conteneur bavard peut remplir /var/lib/docker et donc le disque. On borne, globalement dans /etc/docker/daemon.json :

{
  "log-driver": "json-file",
  "log-opts": { "max-size": "20m", "max-file": "5" }
}

Chaque conteneur garde alors au plus 5 fichiers de 20 Mo. On applique par sudo systemctl restart docker — ce qui redémarre tous les conteneurs, donc à faire dans une fenêtre de maintenance. On peut aussi mettre ces options par service dans le compose (chapitre 7), ce qui évite le restart global.

Récapitulatif

Exercices

$ docker ps -a | grep edge-mqtt
7a2b1c9d8e6f  eclipse-mosquitto:2.0.18  Exited (137) 4 minutes ago  edge-mqtt
$ docker logs --tail 20 edge-mqtt      # que disait-il avant de mourir ?
$ journalctl -k | grep -i oom          # le noyau l'a-t-il tué (OOM) ?

$ docker ps                      # Up ... (unhealthy) ?
$ docker inspect --format '{{json .State.Health}}' edge-gateway
$ docker logs --tail 30 edge-gateway   # session OPC-UA tombée ? broker injoignable ?