Dépannage

Diagnostiquez et corrigez les problèmes courants : une page par famille de symptômes, écrite pour que le correctif soit atteignable sans lire d'abord le reste de la doc.

Dans cette section

• Échecs de build: promotion bloquée, erreurs de rendu, timeouts et rafales de budget d'écriture ; où vivent le texte de la raison et le contrôle « promote anyway ».
• CSS bloqué (SRI): quand l'admin refuse de charger la feuille de style et pourquoi le hash d'intégrité est dérivé du contenu.
• Conflits de ports: quel port appartient à quelle couche, qui le possède, et comment le déplacer proprement.
• Problèmes de connexion & auth: verrouillages, expiration, suspensions, révocation de session.
• Redirections & 404: pourquoi un site statique renvoie 404 là où le CMS répondrait, et les règles des formats de redirection.
• FAQ: le florilège des questions fréquentes (mots de passe, builds, verrouillages, clés API, premier démarrage).

L'habitude qui résout le plus

Deux surfaces répondent à la plupart des questions avant la chasse aux symptômes :

• L'historique des builds (Builds dans l'admin) : les 100 dernières exécutions avec les raisons par vérification, la sortie capturée, et le texte de refus exact des promotions bloquées.
• Le journal (journalctl -u chinaski@<N>), chaque message de niveau service, y compris verrouillages de connexion, échecs de déploiement et issues des webhooks.

/health (multi-vérifications avec détails par vérification) et /api/health (résumé pour les moniteurs) ferment la boucle : quand aucun des deux ne rapporte healthy, le problème est infrastructurel plutôt que de contenu.