Split Docker tutorials into basis, orchestration and dockerfiles

tutorial/dockerfiles/dockerfile.md

@@ -0,0 +1,142 @@
+\newpage
+
+`Dockerfile`
+============
+
+## Ma première image ... par `Dockerfile`
+
+Pour construire une image, nous ne sommes pas obligés de passer par une série
+de commits. Docker dispose d'un mécanisme permettant d'automatiser la
+construction de nouvelles images. Vous pouvez arriver au même résultat que ce
+que l'on a réussi à faire précédemment en utilisant le `Dockerfile` suivant :
+
+```
+FROM ubuntu:latest
+
+RUN apt-get update
+RUN apt-get install -y nano
+```
+
+La syntaxe d'un `Dockerfile` est simple, le premier mot de chaque ligne est
+l'intitulé d'une instruction (que l'on écrit généralement en majuscule), elle
+est suivie de ses arguments.
+
+Dans notre exemple, nous utilisons `FROM` qui indique une image de départ à
+utiliser ; `RUN` est une commande qui sera exécutée dans le conteneur, dans le
+but de le construire.
+
+Pour lancer la construction de la nouvelle image, créer un nouveau dossier ne
+contenant que votre fichier `Dockerfile`, placez-vous dedans, puis utilisez la
+commande `build` :
+
+```
+docker image build --tag=my_editor .
+```
+
+Une fois la construction de l'image terminée, vous pouvez la lancer et
+constater l'existence de notre éditeur favori :
+
+```
+docker container run -it my_editor /bin/bash
+```
+
+
+## `RUN` dans le `Dockerfile`
+
+Dans un `Dockerfile`, chaque ligne est exécutée indépendamment des
+autres et correspondra à une nouvelle couche de notre image.
+
+Cela signifie que l'exemple suivant **ne fonctionne pas** :
+
+```
+COPY db.sql /db.sql
+RUN service mysqld start
+RUN mysql -u root -p toor virli < /db.sql
+```
+
+Cet exemple ne fonctionne pas car le serveur MySQL est lancé dans le premier
+RUN, n'est plus lancé au moment du deuxième RUN. En effet, chaque commande du
+`Dockerfile` a pour but de modifier le système de fichiers.
+
+Pour avoir le résultat escompté, il faut exécuter les commandes ensemble :
+
+```
+COPY db.sql /db.sql
+RUN service mysqld start && mysql -u root -p toor virli < /db.sql
+```
+
+Après le `RUN`, MySQL sera de nouveau arrêté, si on veut l'utiliser dans le
+conteneur, il ne faudra pas oublier de lancer le processus.
+
+
+## Exposer des ports
+
+Construisons maintenant un conteneur avec un serveur web :
+
+```
+FROM my_editor
+
+RUN apt-get update
+RUN apt-get install -y nginx
+
+EXPOSE 80
+```
+
+L'instruction `EXPOSE` sera traité plus tard par le client Docker
+(équivalent à l'argument `--expose`). Il s'agit de préciser les ports
+sur lesquels votre image écoute.
+
+En utilisant l'option `-P` du `run`, vous allez pouvoir assigner une
+redirection de port aléatoire sur la machine hôte vers votre
+conteneur :
+
+```
+docker image build --tag=my_webserver .
+docker container run -it -P my_webserver /bin/bash
+service nginx start
+```
+
+Dans un autre terminal, lancer un `docker ps` et consulter la colonne
+*PORTS* pour connaître le port choisit par Docker pour effectuer la
+redirection.
+
+Rendez-vous ensuite dans votre navigateur sur <http://localhost:49153/>.
+
+À vous de jouer : utilisez l'instruction `COPY` pour afficher votre
+propre `index.html` remplaçant celui installé de base par nginx.
+
+
+## Lancement de commande automatique
+
+Vous pouvez placer dans un `Dockerfile` une instruction `CMD` qui sera
+exécutée si aucune commande n'est passée lors du `run`, par exemple :
+
+```
+CMD nginx -g "daemon off;"
+```
+
+```
+docker image build --tag=my_nginx .
+docker container run -d -P my_nginx
+```
+
+L'option `-d` passée au `run` lance le conteneur en tâche de
+fond. Si vous constatez via un `docker ps` que le conteneur s'arrête
+directement, retirer cette option pour voir ce qui ne va pas, ou
+utilisez la commande `docker logs`.
+
+
+## D'autres instructions ?
+
+Consultez <https://docs.docker.com/engine/reference/builder/> pour la liste complète
+des instructions reconnues.
+
+
+## Rendu
+
+Rendez le fichier `Dockerfile` et son contexte (`index.html`, fichiers de conf
+éventuels, ...) que vous avez utilisé pour réaliser votre image
+`my_webserver`.
+
+Une attention particulière sera apporté au respect des différentes bonnes
+pratiques vues en cours pour l'écriture de `Dockerfile`.