Dépannage
Les messages que vous pouvez rencontrer en publiant, ce qu’ils veulent dire et comment s’en sortir. Si rien ne marche, l’administrateur de la plateforme a les journaux.
Connexion
| Message ou symptôme | Que faire |
|---|---|
Could not resolve hostname adalan | L’alias SSH manque : ajouter le bloc Host adalan à ~/.ssh/config (voir ici). |
Permission denied (publickey) | La clé du poste n’est pas enregistrée, ou SSH en présente une autre : vérifier IdentityFile, sinon envoyer la clé publique à l’administrateur. Si tout fonctionnait jusque-là, le Space a peut-être été désactivé : voir l’administrateur. |
REMOTE HOST IDENTIFICATION HAS CHANGED | Ne pas continuer. Prévenir l’administrateur, qui confirme ou non le changement d’empreinte. |
« … » n'est pas disponible | Le serveur n’accepte que les commandes adalan : pas de shell, ni scp, ni rsync. |
| Connecteur : « Slug du Space ou code d’accès incorrect » | Vérifier le slug du Space, celui de son adresse (durand pour spaces.adalan.ai/durand/, en minuscules), et le code. Code perdu : en générer un nouveau depuis les paramètres de votre Space, ou le demander à l’administrateur. Un Space désactivé est refusé aussi. |
| « Adresse e-mail ou mot de passe incorrect » | L’adresse doit être celle de votre Space. Mot de passe oublié, ou jamais choisi : Première connexion ou mot de passe oublié : recevoir un code, puis choisissez-en un nouveau. Une adresse adalan n’a pas de mot de passe : elle passe par Microsoft. |
| Connecteur : « Trop d’essais » | Après 5 essais faux en un quart d’heure, la page fait attendre. Réessayer dans 15 minutes. |
| Connecteur : « Demande expirée » | La page de connexion est restée ouverte trop longtemps : relancer la connexion depuis claude.ai. |
| Connecteur : Claude demande de se reconnecter | Le code d’accès a changé, ou le connecteur n’a pas servi depuis 30 jours : se reconnecter (Microsoft, adresse e-mail et mot de passe, ou le code actuel). Si la connexion est refusée, le Space a peut-être été désactivé : voir l’administrateur. |
| Connexion Microsoft refusée | Seuls les comptes adalan membres de l’organisation sont admis, et l’adresse du compte doit être celle du Space. Demander à l’administrateur de vérifier l’adresse enregistrée. |
| « Grace ne vous donne pas comme actif » ou « accès suspendu » | Votre fiche dans Grace n’a plus le statut attendu : voir votre responsable ou l’administrateur. Vos sites restent en ligne. |
| Code par e-mail jamais reçu | Il part à l’adresse de votre Space seulement : vérifier l’adresse saisie, regarder dans les courriers indésirables, ou redemander dans quelques minutes. Une adresse adalan passe par Microsoft. |
| « Le délai pour choisir le mot de passe est passé » | Dix minutes après le code, ou une fois le mot de passe enregistré, la page ne sert plus : redemander un code. |
Publication
| Message | Que faire |
|---|---|
l'archive contient seulement le dossier « dist » | Refaire l’archive depuis l’intérieur du dossier : tar -czf - -C dist . |
archive vide | Le dossier envoyé est vide, ou le chemin est faux. |
pas d'index.html à la racine | Le site répondra 404 : ajouter la page d’accueil ou renommer la page principale en index.html. |
fichiers sensibles refusés : … | Retirer ces fichiers du dossier. --force seulement s’ils ne contiennent aucun secret. Le connecteur claude.ai les refuse toujours : Claude les retire de l’envoi, et passe les réglages et les clés par les variables de l’application. |
lien non pris en charge | Remplacer les liens symboliques par de vrais fichiers. |
liens absolus vers la racine (/…) | Rendre relatifs les liens cités (css/style.css au lieu de /css/style.css), ou régler le chemin de base de l’outil de construction, puis republier. |
fichiers PHP dans … | Un site statique sert ces fichiers tels quels, code source compris, sans les exécuter. Retirer ces fichiers et republier, ou publier une application, avec un Dockerfile qui exécute le PHP. |
nom de projet « … » invalide | 3 à 40 caractères : minuscules, chiffres, tirets, sans double tiret. |
« … » est de type static | Un projet garde son type : supprimer le site, puis le republier en application (ou l’inverse), ou choisir un autre nom. |
limite de 20 sites atteinte | Lister les sites et en supprimer un. |
10 nouveaux sites en 7 jours au plus | Mettre à jour un site existant plutôt qu’en créer un, ou réessayer quelques jours plus tard. |
plafond hebdomadaire de nouveaux sites de la plateforme atteint | Garde-fou commun à tous les Spaces : réessayer plus tard, ou prévenir l’administrateur. |
quota du Space atteint | Supprimer des sites, alléger les images et les vidéos, ou demander un quota plus grand. |
l'accès interne demande le SSO adalan | L’accès interne n’est pas encore ouvert sur la plateforme : protéger par mot de passe en attendant. |
| Le site est en ligne mais sans styles ni images | Liens absolus : voir Des liens relatifs. |
pas encore joignable | Réessayer curl -sI adresse une minute plus tard. |
Applications
| Message ou symptôme | Que faire |
|---|---|
Dockerfile absent à la racine | Ajouter un Dockerfile, ou publier sans --type docker s’il s’agit d’un site statique. |
construction de l'image en échec | Lire les dernières lignes affichées, corriger, republier. |
la nouvelle version ne répond pas | L’application doit écouter sur 0.0.0.0 et le port PORT (8080). La version précédente reste en ligne ; lire le journal affiché. |
limite de 3 applications atteinte | Supprimer une application. |
| Appels d’API en 404, pages sans styles | Liens absolus dans les pages ou le JavaScript : les rendre relatifs ou les préfixer par BASE_PATH. |
| Erreur 502 | ssh adalan adalan logs projet : l’application s’est arrêtée ou n’écoute pas sur le bon port. |
Côté visiteurs
| Ce que voit le visiteur | Explication |
|---|---|
| Page 404 adalan | Adresse mal tapée, ou site supprimé. |
| Page « Ce Space est suspendu » (403) | Le Space a été désactivé par l’administrateur ; ses sites reviennent tels quels à la réactivation. |
| Page adalan « Space durand » | Page de connexion du Space, qui liste ses sites, et de ses paramètres (/durand/admin) : son collaborateur y entre avec Microsoft (salarié), son adresse e-mail et son mot de passe (externe), ou son code d’accès, celui du connecteur. |
| Page du Space : « Demande refusée » | L’action a été envoyée d’ailleurs que la page, ou le navigateur est trop ancien : rouvrir la page et recommencer, ou demander l’action à Claude. |
| Page « contenu expiré » | Le site a atteint son échéance : extend le remet en ligne. |
| Page adalan « Mot de passe » | Site protégé : saisir le mot de passe transmis. Perdu : protect projet en génère un nouveau, à retransmettre ; les visiteurs connectés avec l’ancien doivent saisir le nouveau. |
| Page adalan « Connexion », accès interne | Collaborateur : « Se connecter avec Microsoft ». Freelance : demander un code par e-mail, valable 10 minutes. Un visiteur extérieur ne peut pas y entrer. |
| Freelance : aucun code reçu | Regarder les courriers indésirables. Sinon, l’adresse n’est pas inscrite dans Grace (monespace.adalan.ai), ou son statut n’y est pas actif : l’administrateur vérifie avec sudo adalan-admin grace lookup adresse. |
| « Trop de codes demandés » | Trois codes par adresse et par quart d’heure au plus : utiliser le dernier reçu, ou attendre. |
Demander de l’aide
Envoyez à l’administrateur le slug de votre Space, le nom du site, la commande lancée ou la demande faite à Claude, et le message d’erreur complet. Il retrouve l’opération dans le journal d’audit de la plateforme.