TP1: Add images

tutorial/docker-basis/debug.md

@@ -9,8 +9,8 @@ de configuration, ... Lorsque le conteneur est en cours d'exécution, il y a
 plusieurs manières de contrôler ce qu'il se passe.
 
 
-docker logs
------------
+Consulter les journaux
+----------------------
 
 La première étape consiste bien souvent à regarder ce que le conteneur affiche
 sur ses sorties standard et d'erreur. Lorsqu'il est lancé en monde *daemon*, il
@@ -64,8 +64,8 @@ initiale du conteneur se termine, tous les `exec` seront instantanément tués.
 :::::
 
 
-docker top
-----------
+Voir les processus
+------------------
 
 Si plusieurs processus doivent s'exécuter dans un conteneur, un bon moyen de
 savoir s'ils sont tous actifs est d'utiliser :
@@ -79,3 +79,54 @@ docker container top cntr_name
 Cela liste tous les processus rattaché au conteneur nommé : à la fois les
 processus démarrés par le `run`, mais également les éventuels processus
 rattachés par `exec`.
+
+
+Inspecter les propriétés
+------------------------
+
+Pour aller plus loin, découvrons la commande permettant d'afficher les
+propriétés internes des objets Docker.
+
+Peut-être avez-vous encore un conteneur `youp0m` actif ?
+
+<div lang="en-US">
+```bash
+docker container run -d -P registry.nemunai.re/youp0m
+0a1b2c3d4e5f...
+
+docker container inspect 0a1b2c3d4e5f
+[
+  {
+    "Id": "0a1b2c3d4e5f...",
+    "Created": "2032-06-31T18:42:23.0123456789Z",
+    ...
+```
+</div>
+
+Le retour de cette commande va afficher un long enregistrement JSON, rempli
+d'informations importantes pour Docker. Nous y retrouvons par exemple
+l'emplacement réel des points de montage du système de fichiers de notre
+conteneur, les réseaux rejoints, les ports exposés, la commande par
+défaut, ... et tant d'autres choses.
+
+Du fait que la commande retourne un objet JSON, nous pouvons facilement
+réutiliser cette sortie en la passant à l'utilitaire `jq` :
+
+<div lang="en-US">
+```bash
+42sh$ docker container inspect 0a1b2c3d4e5f | \
+    jq -r '.NetworkSettings.Ports["8080/tcp"][0].HostPort'
+49153
+```
+</div>
+
+Cela peut aussi être fait avec l'option `--format`, qui utilise la syntaxe des
+templates du langage Go :
+
+<div lang="en-US">
+```bash
+42sh$ docker container inspect 0a1b2c3d4e5f \
+    -f '{{ (index (index .NetworkSettings.Ports "8080/tcp") 0).HostPort }}'
+49153
+```
+</div>