readme and image docker

docker/docker.md

@@ -1,5 +1,5 @@
 ---
-title: le cours de docker avec des schémas et des commandes interactives pour
+title: le guide de docker avec des schémas et des commandes interactives pour
   les gens largués qui ont besoin d'explications détailées et qui mangent du
   terminal
 sub_title: et les titres à rallonge aussi
@@ -143,6 +143,40 @@ est le "cœur" de Docker, tendis que les commandes servent juste à envoyer des
 requêtes à ce dernier.
 <!-- pr:column: 1 -->
 ![](./pictures/cli-daemon-commmunication.png)
+<!-- pr:end_slide -->
+Docker -- fonctionnement
+===
+# Commandes
+Ok après toute cette théorie, voyons les différentes commandes permettant
+d'interagir avec docker et plus particulièrement avec les images docker.  
+Tout d'abord, les commandes docker sont structurés en 4 parties:
+```bash
+docker <module> <action> <arguments>
+```
+En détail:
+- **docker**: la commande de base pour appeller docker, toutes les commandes
+  commencent par ça.
+  - **\<module\>**: le nom du module de docker que l'on souhaite utiliser,
+    chaque module sert à interagir avec une partie spécifique de docker.
+    Par exemple, le module **image** sert à interagir avec les images docker.
+  - **\<action\>**: L'action du module à réaliser, chaque module possède des
+    actions qui sont lié à son utilisation. Par exemple, pour le module **image**,
+    l'action **pull** sert à télécharger une image depuis dockerhub sur son
+    ordinateur.
+  - **\<arguments\>**: enfin, chaque action vas demander des arguments qui sont détailer
+    dans le manuel de chaque action.
+    par exemple, l'action **pull** du module **image** demander le nom de l'image
+    à télécharger.
+
+Dans la pratique, si je veut télécharger l'image **node:22**, la commande à composer
+sera la suivante: 
+```bash
+docker image pull node:22
+```
+> [!note] Conseil
+> Je vous invite à tester les commandes au fil qu'on les vois afin de les
+tester et de les mémoriser.
+
 <!-- pr:end_slide -->
 Docker -- fonctionnement
 ===
@@ -218,8 +252,34 @@ une image avec la version 22 de node.
 <!-- pr:end_slide -->
 Docker -- fonctionnement
 ===
-# Commandes
-
+# Images
+## Commandes utiles
+```bash
+docker image pull <nom_image>:<tag>
+```
+Cette commande permet de télécharger une image docker depuis internet sur votre
+ordinateur. ex: `docker image pull rancher/cowsay:latest`
+> [!tip]
+> Si aucun tag n'est préciser, la commande téléchargeta le tag *latest*
+```bash
+docker image list
+```
+Cette commande permet de lister les images présente sur votre ordinateur
+```bash
+docker image rm <nom_image>:<tag>
+```
+Cette commande permet de supprimer une image de votre ordinateur
+ex: `docker image rm rancher/cowsay`
+> [!warning]
+> Vous ne pouvez pas supprimer une image en cours d'utilisation par un conteneur !
+> Ainsi, vous devez d'abord supprimer les conteneurs utilisant cette dernière
+> avant de la supprimer.
+```bash
+docker image search <recherche>
+```
+Cette commande permet de chercher des image docker correspondant à une requète,
+de la même façon que sur dockerhub, mais en ligne de commande. ex: `docker image
+search cowsay`
 <!-- pr:end_slide -->
 Docker -- fonctionnement
 ===