Mode maintenance

En cas de problèmes bloquants ou critiques sur la plateforme, il est possible d'activer le mode maintenance.

Le mode maintenance est disponible sur l'environnement de production uniquement.

Il consiste à retourner, pour tout appel à l'API ou à l'application, une même page HTML statique dédiée.

La mise en maintenance est déclenchée manuellement par l'équipe de dév.

Techniquement, la solution mise en oeuvre est faite exclusivement côté Nginx.

Chaque serveur Nginx est configuré de telle façon que s'il détecte la présence d'un fichier /var/www/pix/maintenance_page_on.html, alors la page en question est retournée avec un code retour 503 (pour non-indexation par les moteurs de recherche).

Techniquement, la désactivation du mode maintenance se fait en renommant le fichier maintenance_page_on.html en maintenance_off.html.

Pour simplifier, accélérer et sécuriser la procédure, un script automatisé Ansible d'activation et de désactivation a été mis en oeuvre sur le répertoire pix-fr/infra :

# Depuis le repository pix-fr/infra,
# après avoir ajouté la clé deploy 
# et sourcé le fichier OVH

# Activation :
$ ansible-playbook -i inventories/pix-production activate_maintenance_mode.yml

# Désactivation :
$ ansible-playbook -i inventories/pix-production deactivate_maintenance_mode.yml