From 0b05907597a6a9186b7730a28ce532fc9fcce9f1 Mon Sep 17 00:00:00 2001
From: nemunaire <nemunaire@nemunai.re>
Date: Wed, 3 Oct 2018 10:56:33 +0200
Subject: [PATCH] Add simple Docker exercice with youp0m

---
 tutorial/docker-basis/Makefile    |   2 +-
 tutorial/docker-basis/ex-flask.md | 127 ++++++++++++++++++++++++++++++
 2 files changed, 128 insertions(+), 1 deletion(-)
 create mode 100644 tutorial/docker-basis/ex-flask.md

diff --git a/tutorial/docker-basis/Makefile b/tutorial/docker-basis/Makefile
index 7748c4b..3c505c5 100644
--- a/tutorial/docker-basis/Makefile
+++ b/tutorial/docker-basis/Makefile
@@ -1,4 +1,4 @@
-SOURCES		= tutorial.md installation.md what.md first.md cleaning.md volumes.md linking.md rendu.md
+SOURCES		= tutorial.md installation.md what.md first.md cleaning.md ex-flask.md volumes.md linking.md rendu.md
 PANDOCOPTS	= --latex-engine=xelatex \
 		  --standalone \
 		  --normalize \
diff --git a/tutorial/docker-basis/ex-flask.md b/tutorial/docker-basis/ex-flask.md
new file mode 100644
index 0000000..bbd6ec2
--- /dev/null
+++ b/tutorial/docker-basis/ex-flask.md
@@ -0,0 +1,127 @@
+\newpage
+
+Mon premier webservice
+======================
+
+C'est parti, nous allons déployer notre premier service !
+
+Il s'agit d'un service montrant une image aléatoire à chaque chargement de
+page : <https://you.p0m.fr/>.
+
+
+Nous pouvons télécharger et lancer le service grâce à :
+
+<div lang="en-US">
+```
+docker container run -i nemunaire/youp0m
+```
+</div>
+
+Cette fois-ci, ce n'est pas un shell que nous obtenons[^defaultcmd] : il semblerait que le
+service soit lancé et écoute sur le port 8080. Est-ce le cas ?
+
+<http://localhost:8080>
+
+[^defaultcmd]: Chaque conteneur dispose d'une commande par défaut : les images
+	de base telles que les distributions vont lancer un shell, tandis que les
+	conteneurs de service vont lancer leur service directement.
+
+Non ! Car le service est contenerisé ! Il s'exécute dans son coin, sans
+interférer avec son hôte.
+
+
+## Redirection de ports
+
+Nous pouvons rediriger le port avec l'argument <span lang="en-US">`-p dst_host:src_cntr`</span> :
+
+<div lang="en-US">
+```
+docker container run -i -p 8080:8080 nemunaire/youp0m
+```
+</div>
+
+Cette fois, nous pouvons accéder au service.
+
+Pour le moment, le service ne dispose d'aucune image à afficher, vous pouvez
+utiliser cette syntaxe pour ajouter une image :
+
+<div lang="en-US">
+```
+base64 monimage.jpg | curl --data @- http://localhost:8080/api/images/monimage
+```
+</div>
+
+Si vous n'êtes pas particulièrement inspiré, vous pouvez ajouter ces images :
+
+<div lang="en-US">
+```
+wget -O- https://you.p0m.fr/images/lynx4 | base64 | curl --data @- http://localhost:8080/api/images/lynx
+wget -O- https://you.p0m.fr/images/otters | base64 | curl --data @- http://localhost:8080/api/images/otters
+wget -O- https://you.p0m.fr/images/DNcrZ6u | base64 | curl --data @- http://localhost:8080/api/images/DNcrZ6u
+wget -O- https://you.p0m.fr/images/raccoons | base64 | curl --data @- http://localhost:8080/api/images/raccoons
+```
+</div>
+
+
+## Prêt pour la production ?
+
+Avec l'option `-i`, nous pouvons encore transmettre les signaux de terminaison
+au conteneur. C'est pratique lorsque l'on développe, mais en production, notre
+service ne s'exécutera pas dans notre terminal !
+
+On utilise l'option `-d` pour lancer le conteneur en tâche de fond :
+
+<div lang="en-US">
+```
+docker container run -d -p 8080:8080 nemunaire/youp0m
+```
+</div>
+
+À partir de l'identifiant renvoyé par cette commande (que l'on peut également
+obtenir avec un `docker container ls`), nous pouvons consulter les logs du
+service (en fait, les sorties standard et d'erreur) :
+
+<div lang="en-US">
+```
+docker container logs 0123456789abcdef
+```
+</div>
+
+
+## Une autre instance ?
+
+Maintenant que nous avons un clone de <https://you.p0m.fr/>, nous voulons
+absolument un clone de <https://food.p0m.fr/> !
+
+Il s'agit du même service, mais ce n'est pas les mêmes images.
+
+On ne peut pas utiliser le même port sur la machine hôte, mais pour le reste,
+il s'agit des mêmes options :
+
+<div lang="en-US">
+```
+docker container run -d -p 8080:8081 nemunaire/youp0m
+```
+</div>
+
+Voyons le résultat : <http://localhost:8081>
+
+Nous avons réussi à lancer deux conteneurs à partir de la même image, et on
+voit bien que ceux-ci ne partagent pas leur système de fichiers. Notre nouvelle
+instance est encore immaculée.
+
+
+## Arrêt des conteneurs et persistance des données
+
+Lorsque l'on souhaite stopper un conteneur lancé en tâche de fond, on utilise
+son identifiant dans la commande suivante :
+
+<div lang="en-US">
+```
+docker container stop 0123456789abcdef
+```
+</div>
+
+Maintenant, si l'on relance un conteneur `youp0m`, il aura perdu toutes les
+magnifiques images que l'on aura ajouté. Nous allons voir dans la partie
+suivante comment rendre les données persistantes entre deux lancements.