mode maintenance

HowtoNginx.md

@@ -373,6 +373,42 @@ more_set_headers 'Server: My Server v42'
 
 TODO
 
+### Mode maintenance
+
+Il est possible de déclencher très facilement un mode maintenance avec une page spécifique.
+
+En plaçant cette ligne dans votre bloc "location", il suffira que le fichier `maintenance.html` existe pour que Nginx renvoie systématiquement une erreur 503.
+
+~~~
+location / {
+  if (-f /home/example/www/maintenance.html) { return 503; }
+  […]
+}
+~~~
+
+On personnalise alors la page présentée en cas d'erreur 503, en servant cette même page `maintenance.html`
+
+~~~
+error_page 503 @maintenance;
+location @maintenance {
+  root /home/example/www;
+  rewrite ^(.*)$ /maintenance.html break;
+}
+~~~
+
+En situation normale, on peut avoir le fichier `/home/example/www/_maintenance.html`.
+
+Pour activer le mode maintenance (pas besoin de recharcger Nginx) :
+
+~~~
+$ mv /home/example/www/{_,}maintenance.html
+~~~
+
+Pour désactiver le mode maintenance (pas besoin de recharcger Nginx) :
+
+~~~
+$ mv /home/example/www/{,_}maintenance.html
+~~~
 
 ## Monitoring