Update tuto2

tutorial/dockerfiles/goodpractices.md

@@ -1,12 +1,12 @@
 \newpage
 
-Retour sur les bonnes pratiques
-===============================
+Les bonnes pratiques
+--------------------
 
 Pour chaque bonne pratique ci-dessous, vérifiez que vous la respectez
-bien, faites les modifications nécessaires dans votre `Dockerfile`.
+bien, faites les modifications nécessaire dans votre `Dockerfile`.
 
-## Utilisez le fichier `.dockerignore`
+### Utilisez le fichier `.dockerignore`
 
 Dans la plupart des cas, vos `Dockerfile` seront dans des dossiers contenant
 beaucoup de fichiers qui ne sont pas nécessaire à la construction de votre
@@ -25,7 +25,7 @@ Pour plus d'informations, vous pouvez consulter la documentation accessible à
 <https://docs.docker.com/engine/reference/builder/#dockerignore-file>.
 
 
-## N'installez rien de superflu
+### N'installez rien de superflu
 
 Afin de réduire la quantité de dépendances à installer, n'installez pas de
 paquets dont vous n'avez pas vraiment l'utilité : il n'y a pas de raison par
@@ -33,19 +33,30 @@ exemple d'avoir un éditeur de texte dans un environnement qui sera utilisé
 comme serveur web. Un autre conteneur pourra contenir cet éditeur de texte dans
 les cas où vous avez besoin de modifier des données.
 
-En plus, cela réduira le temps de build et la taille des images produites !
+En plus, cela réduira le temps de construction et la taille des images
+produites !
+
+Avec `apt` par exemple, vous pouvez ajouter l'option `--no-install-recommends`
+lors vous installer un paquet qui vient avec de nombreuses recommandations
+inutiles. C'est le cas par exemple de `ffmpeg` ou de `gstreamer`, qui viennent
+tous deux avec de nombreux *codecs*, mais peut-être que vous savez exactement
+de quels *codecs* vous avez besoin.
 
 
-## Minimisez le nombre de couches
+### Minimisez le nombre de couches
 
 Vous devez trouver l'équilibre idéal entre la lisibilité de votre `Dockerfile`
-(qui assure la maintenabilité sur le long-terme) et le nombre de couches
+(qui assure la maintenabilité sur le long terme) et le nombre de couches
 créées.
 
+Utilisez les constructions en plusieurs étapes pour n'en recopier que les
+éléments utiles dans l'image finale. C'est le meilleur moyen de gagner de la
+place.
 
-## Ordonnez vos lignes de commandes complexes
 
-### Allez à la ligne pour séparer les longues lignes de commandes complexes
+### Ordonnez vos lignes de commandes complexes
+
+#### Allez à la ligne pour séparer les longues lignes de commandes complexes
 
 Aérez vos `Dockerfile` !
 
@@ -64,7 +75,7 @@ RUN apt-get update && apt-get install -y \
 
 Notez les backslashs à la fin des lignes, indiquant qu'elle n'est pas terminée.
 
-### Triez les arguments par ordre alphabétique
+#### Triez les arguments par ordre alphabétique
 
 Lorsque c'est possible, ordonnez vos lignes suivant un ordre logique. Par
 exemple :
@@ -81,7 +92,7 @@ RUN apt-get update && apt-get install -y \
 </div>
 
 
-## Profitez du système de cache
+### Profitez du système de cache
 
 Le processus de construction de votre image Docker va lire les informations de
 votre Dockerfile dans l'ordre. Pour chaque instruction, Docker va essayer de
@@ -93,7 +104,7 @@ Il y a un certain nombre de règles à connaître pour bien utiliser ce mécanis
 - En démarrant d'une image de base déjà présente dans le cache (`docker
   images`), l'instruction suivante est comparée avec toutes les autres images
   existantes qui en dérivent directement. Si aucune image correspondant n'est
-  trouvé pour l'instruction, le cache est invalidé pour le reste de cette
+  trouvée pour l'instruction, le cache est invalidé pour le reste de cette
   construction.
 - Dans la plupart des cas, Docker va simplement comparer l'instruction lue avec
   le(s) différente(s) image(s) qui dérive(nt) de la commande précédente. Si
@@ -106,7 +117,7 @@ Il y a un certain nombre de règles à connaître pour bien utiliser ce mécanis
   dans le `Dockerfile` vont être exécutées.
 
 
-## Concevez des conteneur éphémères
+### Concevez des conteneur éphémères
 
 Les conteneurs que vous générez doivent être aussi éphémères que possible : ils
 devraient pouvoir être arrêtés, détruits et recréés sans nécessiter d'étape de
@@ -114,23 +125,19 @@ reconfiguration. La configuration devrait se faire au lancement du conteneur ou
 lors de sa construction.
 
 
-## Cas d'`apt-get` et des gestionnaires de paquets
+### Cas d'`apt-get` et des gestionnaires de paquets
 
 - N'exécutez pas `apt-get update` seul sur une ligne. Cela risque de poser des
   problèmes de cache, car la ligne ne va jamais changer et le cache sera
   toujours utilisé. Vous risquez de récupérer des paquets qui ne sont pas à
   jour.
-- Évitez de mettre à jour le système fourni (via `apt-get upgrade` ou `apt-get
-  update`). Si l'image n'est pas à jour, contactez son mainteneur. Si vous avez
-  besoin d'une version à jour d'un paquet distribué avec l'image, préférez
-  l'utilisation d'`apt-get install -y foo` qui mettra à jour exclusivement le
-  paquet `foo`, sans altérer le reste du système.
 - Pour assurer une bonne gestion du cache, n'hésitez pas à indiquer les
   versions des programmes que vous voulez installer sur votre ligne de commande
-  `apt-get`.
+  `apt-get`. Lors d'un changement de version, vous changerez la ligne, le cache
+  ne sera donc pas utilisé.
 
 
-## Exposez les ports standards
+### Exposez les ports standards
 
 La commande `EXPOSE`{.dockerfile} vous permet d'indiquer les ports sur lesquels
 votre conteneur s'attend à recevoir des paquets venant de l'extérieur. Ces
@@ -145,7 +152,7 @@ S'il y a un conflit sur la machine hôte, il sera toujours temps de créer une
 redirection à ce moment là.
 
 
-## La bonne utilisation de l'`ENTRYPOINT`
+### La bonne utilisation de l'`ENTRYPOINT`
 
 L'entrypoint peut être utilisé de deux manières différentes :
 
@@ -185,7 +192,7 @@ exec "$@"
 </div>
 
 
-## `[""]`, `'` et sans `[]`
+### `[""]`, `'` et sans `[]`
 
 Les instructions `ENTRYPOINT`{.dockerfile} et `CMD`{.dockerfile} peuvent
 prendre deux formes :
@@ -200,13 +207,13 @@ Les commandes sous forme de tableau étant parsées par un parser JSON, vous ne
 pouvez pas utiliser les simple quotes.
 
 
-## Volumes
+### Volumes
 
 L'instruction `VOLUME`{.dockerfile} doit être utilisée pour exposer tous les
 espaces de stockage de données, configuration,\ ...
 
 
-## Réduisez les privilèges
+### Réduisez les privilèges
 
 Utilisez l'instruction `USER`{.dockerfile} dès que vous le pouvez, lorsqu'un
 service ne réclame pas de privilège particulier.
@@ -214,7 +221,7 @@ service ne réclame pas de privilège particulier.
 Il vous faudra sans doute créer l'utilisateur et son groupe dans le Dockerfile.
 
 
-## Profitez du système de liaison et de résolution de nom
+### Profitez du système de liaison et de résolution de nom
 
 Dès lors que vous effectuez un lien avec un autre conteneur, son nom (ou son
 alias) est ajouté au fichier `/etc/hosts`. Cela signifie que lorsqu'un nom de
@@ -226,7 +233,7 @@ Au moment du `docker run`, vous pouvez préciser d'autres noms d'ĥôtes
 particuliers en utilisant l'option `--add-host`.
 
 
-## Exécutez un seul processus par conteneur
+### Exécutez un seul processus par conteneur
 
 Dans la majorité des cas, vous ne devriez jamais lancer plus d'un seul
 processus par conteneur. Il est préférable de répartir chaque application dans