Switch graphics to new environment

chapters/maintenability.tex

@@ -165,73 +165,76 @@ sur les \emph{releases} de Gitea, sur un serveur d'artefacts (\href{https://fr.w
 \section{Mémoire des processus d'exécution}
 
 Toute information stockée en mémoire ou sur disque ne doit pas altérer le comportement futur de l'application, par exemple après un redémarrage non souhaité.
-Dit autrement, l'exécution de l'application ne doit pas dépendre de la présence d'une information stockée en mémoire ou sur disque.
+Dit autrement, l'exécution de l'application ne doit pas dépendre de la présence d'une information locale à son environnement d'exécution.
 
-Pratiquement, si l'application devait rencontrer un problème, il est nécessaire qu'elle puisse redémarrer rapidement, éventuellement en étant déployée sur un autre serveur - par exemple suite à un problème matériel.
-Toute information stockée physiquement sur le premier hôte durant son exécution sur le premier hôte, puisqu'elle pourra avoir été entretemps perdue.
-Lors d'une initialisation ou réinitialisation, la solution consiste donc à jouer sur les variables d'environnement (cf. \#3) et sur les informations que l'on pourra trouver au niveau des ressources attachées (cf \#4), et faire en sorte que les informations et données primordiales puissent être récupérées ou reconstruites.
+Pratiquement, si l'application devait rencontrer un problème - par exemple suite à un problème matériel -, il est nécessaire qu'elle puisse redémarrer rapidement, éventuellement en étant déployée sur un autre serveur.
+Toute information stockée physiquement durant son exécution sur le premier hôte, sera perdue lors de son déploiement ultérieur à un autre endroit.
+Lors de l'initialisation ou de la réinitialisation d'une application, la solution consiste à jouer sur les variables d'environnement (cf. \#3) et sur les informations que l'on pourra trouver au niveau des ressources attachées (cf \#4), afin de faire en sorte que les informations et données primordiales puissent être récupérées ou reconstruites, et donc réutilisées, sans altérer le comportement attendu.
 
-Il serait également difficile d'appliquer une mise à l'échelle de l'application, en ajoutant un nouveau serveur d'exécution, si une donnée indispensable à son fonctionnement devait se trouver sur la seule machine où elle est actuellement exécutée.
+Ceci joue également sur les possibilités de mise à l'échelle: en ajoutant un nouveau serveur d'exécution, si une donnée indispensable à son fonctionnement devait se trouver sur la seule machine où elle est actuellement exécutée, elle en sera inconnue.
+
+-> Ajouter un schéma.
 
 \section{Liaison des ports}
 
-Les applications 12-factors sont auto-contenues et peuvent fonctionner
-en autonomie totale. Elles doivent être joignables grâce à un mécanisme
-de ponts, où l'hôte qui s'occupe de l'exécution effectue lui-même la
-redirection vers l'un des ports ouverts par l'application, typiquement,
-en HTTP ou via un autre protocole.
+Les applications 12-factors sont auto-contenues et peuvent fonctionner en autonomie totale.
+Elles doivent être joignables grâce à un mécanisme de ponts, où l'hôte qui s'occupe de l'exécution effectue lui-même la redirection vers l'un des ports ouverts par l'application, typiquement, en HTTP ou via un autre protocole.
 
-\begin{figure}[H]
-  \centering
-  \scalebox{1.0}{\includegraphics[max size={\textwidth}{\textheight}]{images/diagrams/12-factors-7.png}}
-\end{figure}
+\begin{graphic}{images/diagrams/12-factors-7.png}
+  \caption{Liaison des ports entre le monde extérieur et ce qu'offre l'application}
+\end{graphic}
 
 L'application fonctionne de manière autonome et expose un port (ici, le 8000).
 Le serveur (= l'hôte) choisit d'appliquer une correspondance entre "son" port 443 et le port offert par l'application (8000).
 
 \section{Connaissance et confiance des processus systèmes}
 
-Comme décrit plus haut (cf. \#6), l'application doit utiliser des processus \emph{stateless} (sans état). Nous pouvons créer et utiliser des processus supplémentaires pour tenir plus facilement une lourde charge, ou dédier des   particuliers pour certaines tâches: requêtes HTTP \emph{via} des processus Web; \emph{long-running} jobs pour des processus asynchrones, \ldots
-Si cela existe sur l'hôte hébergeant l'application, ne vous fatiguez pas: utilisez le.
+Comme décrit plus haut (cf. \#6), l'application doit utiliser des processus \emph{stateless} (sans état).
+Nous pouvons créer et utiliser des processus supplémentaires pour tenir plus facilement une lourde charge, ou dédier des particuliers pour certaines tâches:
 
-\begin{figure}[H]
-  \centering
-  \scalebox{1.0}{\includegraphics[max size={\textwidth}{\textheight}]{images/12factors/process-types.png}}
-\end{figure}
+\begin{itemize}
+  \item Requêtes HTTP \emph{via} des processus Web;
+  \item \emph{long-running} jobs pour des processus asynchrones,
+  \item \ldots
+\end{itemize}
+
+Si l'un des concepts dont vous avez besoin existe sur l'hôte hébergeant l'application, ne vous fatiguez pas: utilisez le et ne réinventez pas la roue.
 
 \section{Arrêts élégants et démarrages rapides}
 
-Par "arrêt élégant", nous voulons surtout éviter le fameux
-\texttt{kill\ -9\ \textless{}pid\textgreater{}} (ou équivalent), ou tout autre arrêt brutal d'un processus qui nécessiterait une intervention urgente du
+Par "arrêt élégant", nous voulons surtout éviter le fameux \texttt{kill\ -9\ \textless{}pid\textgreater{}} (ou équivalent), ou tout autre arrêt brutal d'un processus qui nécessiterait une intervention urgente du
 superviseur.
-En prévoyant une manière élégante d'envoyer un signal de terminaison,
+En prévoyant une manière élégante d'envoyer un signal de terminaison:
 
 \begin{enumerate}
 	\item Les requêtes en cours peuvent se terminer au mieux,
 	\item Le démarrage rapide de nouveaux processus améliorera la balance d'un processus en cours d'extinction vers des processus tout frais, en autorisant l'exécution parallèle d'anciens et de nouveaux "types" de processus
 \end{enumerate}
 
-L'intégration de ces mécanismes dès les premières étapes de
-développement limitera les perturbations et facilitera la prise en
-compte d'arrêts inopinés (problème matériel, redémarrage du système
-hôte, etc.).
+L'intégration de ces mécanismes dès les premières étapes de développement limitera les perturbations et facilitera la prise en compte d'arrêts inopinés (problème matériel, redémarrage du système hôte, etc.).
 
-\begin{figure}[H]
-  \centering
-  \scalebox{1.0}{\includegraphics[max size={\textwidth}{\textheight}]{images/12factors/process-type-chronology.png}}
-\end{figure}
+\begin{graphic}{images/12factors/process-types.png}
+
+\end{graphic}
 
 \section{Similarité des environnements}
 
-Conserver les différents environnements aussi similaires que possible, et limiter les divergences entre un environnement de développement et de production.
+\begin{dangerbox}
+  Conservez les différents environnements aussi similaires que possible, et limitez les divergences entre un environnement de développement et de production.
+\end{dangerbox}
 
-L'exemple donné est un développeur qui utilise macOS, NGinx et SQLite, tandis que l'environnement de production tourne sur une CentOS avec Apache2 et PostgreSQL.
-Faire en sorte que tous les environnements soient les plus similaires possibles limite les divergences entre environnements, facilite les déploiements et limite la casse et la découverte de modules non compatibles, au plus proche de la phase de développement, selon le principe de la corde d'Andon \cite[p. 140]{devops_handbook} \index{Andon} \footnote{Pour donner un exemple tout bête, SQLite utilise un
-mécanisme de stockage dynamique \footnote{\url{https://www.sqlite.org/datatype3.html}}, associée à la valeur plutôt qu'au schéma, \emph{via} un système d'affinités. Un autre moteur de base de données définira un schéma statique et rigide, où la valeur sera déterminée par son contenant.
-Un champ \texttt{URLField} proposé par Django a une longeur maximale par défaut de 200 caractères \footnote{\url{https://docs.djangoproject.com/en/3.1/ref/forms/fields/\#django.forms.URLField}}.
-Si vous faites vos développements sous SQLite et que vous rencontrez une URL de plus de 200 caractères, votre développement sera passera parfaitement bien, mais plantera en production (ou en \emph{staging}, si vous faites les choses un peu mieux) parce que les données seront tronquées, et que cela ne plaira pas à la base de données.
+L'exemple donné est un développeur qui utilise macOS, NGinx et SQLite pour l'élaboration d'une application, tandis que l'environnement de production tourne sur une machine Debian avec Apache2 et PostgreSQL.
+Faire en sorte que tous les environnements soient les plus similaires possibles limite les divergences entre environnements, facilite les déploiements et limite la casse et la découverte de modules non compatibles, au plus proche de la phase de développement, selon le principe de la corde d'Andon \cite[p. 140]{devops_handbook} \index{Andon}
 
-Conserver des environements similaires limite ce genre de désagréments.}
+\begin{memorizebox}
+  Pour donner un exemple tout bête, SQLite utilise un mécanisme de stockage dynamique \footnote{\url{https://www.sqlite.org/datatype3.html}}, associée à la valeur plutôt qu'au schéma, \emph{via} un système d'affinités.
+  Un autre moteur de base de données définira un schéma statique et rigide, où la valeur sera déterminée par son contenant.
+
+  Un champ \texttt{URLField} proposé par Django a une longeur maximale par défaut de 200 caractères \footnote{\url{https://docs.djangoproject.com/en/3.1/ref/forms/fields/\#django.forms.URLField}}.
+  Si vous faites vos développements sous SQLite et que vous rencontrez une URL de plus de 200 caractères, votre développement sera passera parfaitement bien, mais plantera en production (ou en \emph{staging}, si vous faites les choses un peu mieux) parce que les données seront tronquées, et que cela ne plaira pas à la base de données.
+
+  Conserver des environements similaires limite ce genre de désagréments.
+\end{memorizebox}
 
 Ceci permet également de proposer à nos utilisateurs un bac à sable dans lequel ils pourront explorer et réaliser des expérimentations en toute sécurité, sans quel cela n'ait d'impact sur un \textit{réel} environnement de production, où les conséquences pourraient être beaucoup plus graves. \cite[p. 9]{data_design}