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 → le certificat n'est pas encore émis, car le nom doit se résoudre vers la plateforme avant qu'il puisse l'être.
  • 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é

Il est impossible de le récupérer. 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. Toute application qui l'utilise redémarre avec la nouvelle.

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, sauf si vous aviez activé les sauvegardes. C'est pour cela que la confirmation est fastidieuse, et que la page Premiers pas vous demande d'activer les 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.