numerique-gouv/b3desk

Pages d'erreur statiques

azmeuk opened this issue · 4 comments

Lorsqu'un problème survient sur le serveur d'application et que le serveur web doit renvoyer un code 503 au client, pour le moment c'est la page blanche par défaut de nginx qui est servie.

Pour une meilleure expérience utilisateur, on devrait implémenter une page d'erreur statique à afficher lorsque l'application renvoie des code 5xx qui ne sont pas gérés par le serveur d'application.

Ça se configure sur nginx avec error_page.

7a7770a

@BHoury
Dans la configuration nginx, il faudra ajouter :

error_page 500 502 503 504 /static/errors/custom_50x.html;

Il faudra imperativement que la conf nginx fasse pointer static vers le bon dossier :

location  = /static {
    root /var/www/html/ ;
}

Il faudra penser à tester que les chemins écrits en dur dans la page custom_50x.html sont bien fonctionnels en production, par exemple en ajoutant la conf

location /get_500_error {
    return 500;
}

et en se rendant sur la page /get_500_error

Pour mémoire la page statique d'erreur a cet aspect.
Screenshot 2024-01-26 at 11-45-41 B3Desk - Erreur

@BHoury je viens de publier la version 1.1.3 qui apporte cette page d'erreur statique comme seule modification.

J'ai rajouté un paragraphe à ce sujet dans la documentation : https://b3desk.readthedocs.io/fr/latest/maintainers/settings.html#nginx