Quand ça ne va pas

Les pannes que vous rencontrerez le plus probablement, ce que chacune signifie réellement, et quoi faire.

Classées par fréquence plutôt que par gravité.

Mon application ne démarre pas

Lisez les journaux de la copie qui a échoué, pas ceux de l'application en général. Les journaux des copies qui ne sont jamais devenues saines sont conservés précisément pour cela.

Par ordre de probabilité :

  1. Une valeur d'environnement manquante. L'application lit un paramètre au démarrage, ne le trouve pas, et s'arrête. Le journal le nomme généralement.
  2. Quelque chose dont elle dépend n'est pas encore joignable. Une base de données commandée il y a une minute n'a peut-être pas fini d'élire sa primaire. Relancez le déploiement.
  3. Elle écoute sur un autre port que celui indiqué à la plateforme : elle tourne parfaitement, et rien ne peut l'atteindre.
  4. Elle se lie à localhost. À l'intérieur de sa propre copie, localhost signifie uniquement cette copie. Liez-la à toutes les interfaces.
  5. Elle est lente à démarrer. La plateforme attend qu'une nouvelle copie réponde pendant un délai généreux, mais limité. Une application qui exécute des migrations, préchauffe un cache et construit un index avant de répondre peut le dépasser. Répondez d'abord, faites ce travail en arrière-plan.

Le déploiement a échoué, mais mon site est toujours en ligne

C'est le comportement prévu. Une nouvelle version qui ne répond jamais ne remplace pas celle qui sert. Lisez les journaux du déploiement échoué ; la version en service n'est pas touchée.

Le déploiement a réussi, mais je vois toujours l'ancienne version

Trois possibilités, dans l'ordre :

  • Votre navigateur l'a mise en cache. Essayez une fenêtre de navigation privée avant toute autre chose.
  • Une connexion déjà ouverte. Les connexions existantes peuvent se terminer au lieu d'être coupées au milieu d'une réponse. Un client qui garde une connexion de longue durée continue de parler à l'ancienne copie jusqu'à ce qu'il se reconnecte.
  • Votre propre cache. Si vous avez placé un cache devant votre application, il sert ce qu'on lui a dit de conserver.

Mon domaine personnalisé ne fonctionne pas

Voir Adresses et domaines pour la liste complète. En bref :

  • Il fonctionne pour vous et pas pour un collègue → le changement n'a pas encore atteint tout le monde. Attendez.
  • La version non sécurisée se charge, la version sécurisée non → aucun certificat valide pour ce nom ne figure sur la page de l'application. Votre propre domaine n'en reçoit pas automatiquement : téléversez-le à cet endroit.
  • Rien ne se résout du tout → vérifiez que l'enregistrement existe bien, et que rien d'autre chez votre registraire ne l'a écrasé.

L'adresse de la plateforme fonctionne toujours. Utilisez-la pour confirmer que l'application elle-même est saine avant de passer du temps sur le DNS.

Ça fonctionnait, et maintenant c'est lent

Vérifiez s'il s'agit d'une copie ou de toutes. Une seule copie lente, c'est généralement cette copie — elle sera remplacée. Toutes, c'est généralement quelque chose de partagé : la base de données, un service externe que vous appelez, ou votre propre trafic.

Vérifiez d'abord la base de données. La plupart des signalements « l'application est lente » sont une requête devenue plus lente parce qu'une table a grossi. C'est de loin la cause la plus fréquente.

Vérifiez si votre débit est limité par quelque chose que vous appelez. Un service externe qui vous refuse produit une application lente, pas une page d'erreur, si votre code réessaie patiemment.

La plateforme limite mon débit

C'est vous qui avez fixé cette limite. Relevez-la, ou supprimez-la. Si ce n'est pas vous, quelqu'un de votre organisation l'a fait — l'historique indique qui, et quand.

J'ai perdu un mot de passe ou une clé

Un secret ne peut pas être récupéré. Les secrets sont en écriture seule par conception : une valeur que l'on peut relire sur une page web est une valeur qui s'échappe dans une capture d'écran. Remplacez-la, puis redéployez l'application : elle reçoit la nouvelle valeur à son prochain déploiement.

Le mot de passe d'une base de données n'est pas perdu : ses informations de connexion peuvent être affichées de nouveau dans la console. Voir Bases de données.

J'ai supprimé quelque chose par erreur

Une application peut être redéployée à partir du même dépôt.

Une base de données ou un espace de stockage a disparu, avec tout ce qu'il contenait. Une instance de base de données est sauvegardée chaque jour, sauf si vous l'avez désactivé, mais ne comptez pas retrouver ses sauvegardes une fois l'instance supprimée : téléchargez d'abord celle que vous voulez garder. C'est pour cela que la confirmation est fastidieuse, et que la page Premiers pas vous demande de vérifier vos sauvegardes avant d'en avoir besoin.

Un domaine peut être rattaché de nouveau ; l'enregistrement chez votre registraire n'est pas touché.

Tout est injoignable dans une région

Consultez la page d'état avant de supposer que le problème vient de vous. Si une région entière est touchée, la plateforme le sait et y travaille ; ouvrir un ticket n'apporte rien, mais n'est pas découragé.

Ce que vous pouvez faire, si vous l'avez prévu : avoir vos données dans une autre région, et une application là-bas pour les servir. Ce que vous ne pouvez pas faire, c'est déplacer une base de données en service d'une région à une autre pendant une panne — cette copie doit avoir existé auparavant.

Bien demander de l'aide

Indiquez, dans cet ordre :

  1. L'application ou la base de données, par son nom.
  2. Son adresse sur la plateforme — celle sous le domaine de la plateforme, qui fonctionne même quand votre propre nom ne fonctionne pas.
  3. Quand cela a commencé, aussi précisément que possible. C'est l'information la plus utile que vous puissiez fournir, et celle qui est le plus souvent oubliée.
  4. Ce que vous avez modifié en dernier, même si vous êtes sûr que cela n'a aucun rapport.
  5. L'erreur exacte, copiée plutôt que décrite.

Voir Disponibilité et support pour savoir quelle réponse attendre, et dans quel délai.