From 2d03001aa4393e8293bba09647280e91b922c2e0 Mon Sep 17 00:00:00 2001
From: jlecour <jlecour+gitit@evolix.fr>
Date: Fri, 2 Mar 2018 10:40:26 +0100
Subject: [PATCH] mode maintenance

---
 HowtoNginx.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/HowtoNginx.md b/HowtoNginx.md
index 30198d02..29a710b9 100644
--- a/HowtoNginx.md
+++ b/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