Dépannage

Commencez par déterminer si le problème concerne HTTPS, le démarrage de l’application ou la connexion GitHub.

#Le site ne s’ouvre pas de façon sécurisée

Vérifiez que le DNS du domaine pointe vers le serveur et que les ports 80 et 443 sont accessibles. Retirez un enregistrement AAAA incorrect. Assurez-vous qu’un autre service n’utilise pas déjà ces ports.

docker compose ps
docker compose logs --tail=100 caddy

#L’application ne démarre pas

docker compose logs --tail=100 app
docker compose logs --tail=100 db

Recherchez une erreur de connexion à la base ou de migration. Utilisez le même fichier .env et le même projet Compose que l’installation existante. Modifier .env ne réinitialise pas le mot de passe d’une base PostgreSQL déjà initialisée.

Ne supprimez pas les volumes pour tenter de résoudre le problème. Consultez les sauvegardes et la récupération avant de remplacer des données.

#Le lien de configuration est introuvable

Retrouvez-le sur le serveur :

docker compose exec app gradepush-setup

Gardez le résultat privé. Modifier SETUP_TOKEN ne permet pas de rouvrir la configuration une fois l’établissement configuré.

#La connexion GitHub ou la création du dépôt échoue

Vérifiez le compte GitHub utilisé, son rôle de propriétaire de l’organisation et l’installation de la bonne GitHub App avec les accès requis aux dépôts. Vérifiez que les adresses publiques de retour et de webhook pointent vers votre installation.

Consultez les journaux de l’application et les livraisons récentes de webhooks sur GitHub. Si l’application a été retirée ou si ses permissions ont changé, reconnectez-la depuis les paramètres de l’organisation.

#Les tests ou les envois n’apparaissent pas

Vérifiez que le commit est arrivé sur la branche désignée du devoir dans GitHub. Assurez-vous que GitHub Actions est activé et que l’exécution est terminée. Consultez les livraisons de webhooks et les journaux de l’application si les résultats sont prêts mais absents de GradePush.

Avant de partager un diagnostic, retirez les jetons, les liens de configuration privés et les renseignements étudiants. Indiquez la version de GradePush, l’action concernée et un message d’erreur nettoyé.