Relecture du fichier main

source/part-2-deployment/00-main.adoc

@@ -1,24 +1,32 @@
 = Déploiement
 
-On va déjà parler de déploiement. Le serveur que django met à notre disposition est prévu uniquement pour le développement: inutile de passer par du code Python pour charger des fichiers statiques (feuilles de style, fichiers JavaScript, images, ...). De même, la base de donnée doit supporter plus qu'un seul utilisateur: SQLite fonctionne très bien dès lors qu'on se limite à un seul utilisateur... Sur une application Web, il est plus que probable que vous rencontriez rapidement des erreurs de base de données verrouillée pour écriture par un autre processus. Il est donc plus que bénéfique de passer sur quelque chose de plus solide. https://docs.djangoproject.com/fr/3.0/howto/deployment/[Déploiement].
 
-Si vous avez suivi les étapes jusqu'ici, vous devriez à peine disposer d'un espace de travail proprement configuré, d'un modèle relativement basique et d'une configuration avec une base de données simpliste. En bref, vous avez quelque chose qui fonctionne, mais qui ressemble de très loin à ce que vous souhaitez au final.
+Nous sommes encore au début du projet mais abordons dès maintenant le déploiment. Il y a plusieurs raisons pour le faire.
 
-Il y a une raison très simple à aborder le déploiement dès maintenant: à trop attendre et à peaufiner son développement en local, on en oublie que sa finalité sera de se retrouver exposé sur un serveur. On risque d'avoir oublié une partie des désidérata, d'avoir zappé une fonctionnalité essentielle ou simplement de passer énormément de temps à adapter les sources pour qu'elles fonctionnent sur un environnement en particulier.
+La première est que le serveur que Django met à notre disposition n'est prévu que pour le développement : inutile de passer par du code Python pour charger des fichiers statiques (feuilles de style, fichiers JavaScript, images, ...).
+Il est également probable que la base de donnée de votre application doive supporter plus d'un utilisateur.
+SQLite fonctionne très bien dès lors qu'on se limite à un seul utilisateur : vous risquez de rencontrer des erreurs de base de données verrouillée pour écriture car un autre processus y accède déjà.
+Il est donc nécessaire d'avoir un environnement plus solide pour la production.
+https://docs.djangoproject.com/fr/3.0/howto/deployment/[Déploiement].
 
-Aborder le déploiement maintenant permet également de rédiger dès le début les procédures d'installation, de mise à jour et de sauvegardes. Déploier une nouvelle version sera aussi simple que de récupérer la dernière archive depuis le dépôt, la placer dans le bon répertoire, appliquer des actions spécifiques (et souvent identiques entre deux versions), puis redémarrer les services adéquats.
+Une autre raison de s'intéresser au déploiment dès à présent est qu'à trop attendre et peaufiner son développement en local, sa finalité (se retrouver exposé sur un serveur) risque d'être perdue de vue.
+Vous risquez d'oublier une partie des désidérata ou une fonctionnalité essentielle, de passer énormément de temps à adapter les sources pour qu'elles fonctionnent sur un environnement en particulier.
 
-Dans cette partie, on abordera les points suivants:
+Aborder le déploiement très tôt permet également de rédiger dès le début les procédures d'installation, de mise à jour et de sauvegardes.
+Déployer une nouvelle version sera aussi simple que de récupérer la dernière archive depuis le dépôt, la placer dans le bon répertoire, appliquer des actions spécifiques (et souvent identiques entre deux versions), puis redémarrer les services adéquats.
 
-* La définition de l'infrastructure nécessaire à notre application
-* La configuration de l'hôte, qui hébergera l'application: dans une machine physique, virtuelle ou dans un container. On abordera aussi rapidement les déploiements via Ansible, Chef, Puppet ou Salt.
-* Les différentes méthodes de supervision de l'application: comment analyser les fichiers de logs et comment intercepter correctement une erreur si elle se présente et comment remonter l'information.
+Dans cette partie, les points suivants serons abordés :
+
+* La définition de l'infrastructure nécessaire à notre application.
+* La configuration de l'hôte, qui hébergera l'application : dans une machine physique, virtuelle ou un container. On abordera aussi rapidement les déploiements via Ansible, Chef, Puppet ou Salt.
+* Les différentes méthodes de supervision de l'application : comment analyser les fichiers de logs et comment intercepter correctement une erreur si elle se présente et comment remonter l'information.
 * Une partie sur la sécurité et la sécurisation de l'hôte.
 
-Si on schématise l'infrastructure et le chemin parcouru par une éventuelle requête, on devrait arriver à quelque chose de synthéthique:
+=== Infrastructure
+L'infrastructure et le chemin parcouru par une éventuelle requête peut être schématisé de la manière suivante :
 
 * Au niveau de l'infrastructure, 
-    . l'utilisateur fait une requête via son navigateur (Firefox ou Chrome) 
+    . l'utilisateur fait une requête via son navigateur (Firefox, Chrome, …) 
     . le navigateur envoie une requête http, sa version, un verbe (GET, POST, ...), un port et éventuellement du contenu
     . le firewall du serveur (Debian GNU/Linux, CentOS, ...) vérifie si la requête peut être prise en compte 
     . la requête est transmise à l'application qui écoute sur le port (probablement 80 ou 443; et _a priori_ Nginx)
@@ -37,19 +45,20 @@ image::images/diagrams/architecture.png[]
 
 image::images/diagrams/django-process.png[]
 
-== Définition de l'infrastructure
+==== Définition de l'infrastructure
 
-Comme on l'a vu dans la première partie, Django est un framework complet, intégrant tous les mécanismes nécessaires à la bonne évolution d'une application. On peut ainsi commencer petit, et suivre l'évolution des besoins en fonction de la charge estimée ou ressentie, ajouter un mécanisme de mise en cache, des logiciels de suivi, ...
+Comme abordé dans la première partie, Django est un framework complet intégrant tous les mécanismes nécessaires à la bonne évolution d'une application.
+Il est ainsi possible commencer petit et de suivre l'évolution des besoins en fonction de la charge estimée ou ressentie, d'ajouter un mécanisme de mise en cache, des logiciels de suivi, etc.
 
-Pour une mise ne production, le standard *de facto* est le suivant:
+Pour une mise ne production, le standard *de facto* est le suivant :
 
- * Nginx comme reverse proxy
- * Gunicorn ou Uvicorn comme serveur d'application
- * Supervisorctl pour le monitoring
- * PostgreSQL ou MariaDB comme base de données.
- * Redis / Memcache pour la mise à en cache (et pour les sessions ? A vérifier).
+ * _Nginx_ comme reverse proxy
+ * _Gunicorn_ ou Uvicorn comme serveur d'application
+ * _Supervisorctl_ pour le monitoring
+ * _PostgreSQL_ ou _MariaDB_ comme base de données.
+ * _Redis_ ou _Memcache_ pour la mise à en cache (et pour les sessions ? A vérifier).
 
-En mode _containers_, on passera plutôt par Docker et Traefik.
+En mode _containers_, nous conseillons Docker et Traefik.
  
 C'est celle-ci que nous allons décrire ci-dessous.