Maintenance

Une fenêtre de maintenance est une coupure des alertes décidée à l'avance, avec une fin qu'on ne peut pas oublier de rétablir et une raison qui explique le trou dans l'historique une semaine plus tard. C'est la différence avec « Couper 4 h », qu'on presse après que la sirène a sonné. Pendant la fenêtre, les vérifications continuent : l'historique reste vrai sur ce que le site a fait, seuls les envois sont retenus.

Ce que PostShip fait

Deux formes, qui s'additionnent :

• La fenêtre ponctuelle : un début, une fin, une raison facultative (80 caractères). Elle se termine d'elle-même ; il n'y a rien à réactiver.
• La maintenance récurrente : des jours de la semaine, une heure de début, une heure de fin, un fuseau, une raison facultative. « Tous les dimanches de 03:00 à 04:30 (Europe/Paris) », réglé une fois. Si la fin précède le début, la fenêtre court jusqu'au lendemain : « samedi de 23:00 à 01:00 » couvre bien le dimanche à 0 h 30.

Pendant l'une ou l'autre :

• Aucune alerte ne part, sur aucun canal, pour aucune URL du projet. C'est le même tout-ou-rien que les heures calmes de Règles.
• Le badge public affiche « maintenance » plutôt que « up ».
• La page de statut passe en état dégradé avec la raison, et la carte de ship le mentionne.
• La cause probable d'un incident ouvert pendant la fenêtre retient « Maintenance annoncée » avec le score le plus fort : c'est la seule cause qu'on peut presque affirmer, quelqu'un l'a annoncée.

Et avant :

• La page de statut annonce une fenêtre ponctuelle à venir dans les 24 heures, avec l'heure et la raison. Au-delà de 24 h, l'information ne sert pas à celui qui vient de trouver le site lent.
• Le calendrier public liste tout ce qui est prévu sur 30 jours (12 occurrences au plus), ponctuelle comprise, et le sert aussi en .ics à l'adresse /s/votre-slug/maintenance.ics pour Google Agenda, Outlook ou Apple. Voir Calendrier de maintenance.

Régler

Projet → Paramètres → Règles.

Fenêtre de maintenance

Carte « Fenêtre de maintenance » : Début, Fin (date et heure locales), « Raison (facultatif) », par exemple « migration Postgres ». Enregistrer. Videz les deux dates pour annuler la fenêtre. Quand elle est en cours, la carte l'écrit : « Maintenance en cours jusqu'au 14/09 04:30 — migration Postgres. »

Maintenance récurrente

Carte « Maintenance récurrente » : cochez les jours (L M M J V S D), De, À, Fuseau, raison. Enregistrer. Décochez tous les jours pour retirer la règle. La carte résume ce qui est réglé : « Réglée : tous les dimanches de 03:00 à 04:00 (Europe/Paris) », ou « En cours — … » pendant la fenêtre.

Ce qui déclenche une alerte

Rien pendant la fenêtre. Une panne qui commence pendant la maintenance et dure après n'est pas rejouée à la fin : PostShip n'alerte qu'à la transition, et l'incident reste visible dans Projet → Incidents. Une panne qui commence après la fin alerte normalement.

L'encadré « En l'état » de Règles vous le dit quand c'est le cas : « Une fenêtre de maintenance court jusqu'au 14/09 04:30 : rien ne sortira d'ici là. » ou « Maintenance récurrente en cours — tous les dimanches de 03:00 à 04:00 (Europe/Paris) : rien ne sort d'ici la fin. » Une fenêtre programmée pour la semaine prochaine n'y apparaît pas : elle n'explique pas un silence d'aujourd'hui.

Limites et plans

La page de statut et son calendrier existent sur tous les plans ; ils n'annoncent une maintenance que si une fenêtre a pu être réglée. Voir les plans.

Dépannage

Pourquoi une alerte est partie pendant ma maintenance ?

Vérifiez le fuseau de la règle récurrente : une fenêtre « 03:00–04:00 » en UTC n'est pas 3 h à Paris. La fenêtre ponctuelle, elle, est saisie dans votre heure locale. L'encadré « En l'état » dit si une fenêtre est en cours au moment où vous le lisez.

Pourquoi la page de statut n'annonce pas ma fenêtre de la semaine prochaine ?

L'annonce en tête de page ne porte que sur les 24 heures à venir. La fenêtre est bien dans le calendrier des 30 prochains jours et dans le flux .ics.

Pourquoi le badge dit « maintenance » alors que rien n'est en cours ?

Une règle récurrente est en cours à cette heure-là. Regardez la carte « Maintenance récurrente » : elle affiche « En cours — … » quand c'est le cas.