SmartFlow Host

Ressources

Dépannage

Les problèmes fréquents et leur solution.

Mon domaine reste en attente

  • Vérifiez le nom du TXT : _agenthost.votre-domaine, pas _agenthost seul. Certains hébergeurs ajoutent le domaine tout seul : saisissez alors seulement _agenthost.www.
  • Pour un domaine racine, il faut un A, pas un CNAME.
  • Un ancien enregistrement A ou AAAA vers un autre hébergeur peut masquer le nouveau : supprimez-le.
  • La propagation peut prendre quelques heures. Cliquez sur Vérifier, ou attendez la vérification automatique toutes les 15 minutes.
Terminal
dig +short TXT _agenthost.www.exemple.ch
dig +short CNAME www.exemple.ch

La CLI répond 403

La clé est absente, mal copiée ou révoquée. Vérifiez qu'elle commence par ah_ et qu'elle passe bien par --token ou VERCEL_TOKEN. Une clé cesse aussi de fonctionner quand la personne qui l'a créée quitte l'équipe ou passe en lecture seule. Vérifiez enfin que --api https://api.host.hgdc.ch est présent : sans lui, la CLI parle à Vercel.

Le message Cette clé est limitée à un autre projet signifie que vous utilisez la clé posée dans un dépôt pour un autre projet : créez une clé d'équipe.

La CLI affiche missing_files

C'est normal : la plateforme demande les fichiers qu'elle n'a pas encore, la CLI les envoie puis rappelle l'API. Si l'erreur persiste, un fichier n'a pas pu être envoyé : il dépasse 20 Mo, ou le réseau a coupé. Relancez le déploiement.

Mon build GitHub n'apparaît pas

  • La PR du workflow est-elle fusionnée sur la branche poussée ? Le fichier .github/workflows/smartflow-host.yml doit exister sur cette branche.
  • Ouvrez l'onglet Actions du dépôt : le run y est, avec son erreur.
  • Le secret SMARTFLOW_HOST_TOKEN manque ou a été supprimé : débranchez puis reliez le dépôt pour en poser un nouveau.
  • Le projet a été importé avant une évolution du workflow : utilisez Mettre à jour le workflow dans l'onglet Git.

Mon site affiche 404

  • Le dossier envoyé n'a pas d'index.html à sa racine, ou le dossier de sortie configuré est faux. Voir Site statique.
  • La page est rendue à la demande (SSR) et l'exécution des fonctions n'est pas encore ouverte à votre équipe (page 501) : pré-rendez-la, ou demandez l'accès. Voir Frameworks.
  • Sans cleanUrls, /a-propos ne trouve pas a-propos.html.
  • Le message de publication, sur la page du déploiement, liste les fichiers et fonctions ignorés.

vercel login ne fonctionne pas

C'est voulu : la connexion passe toujours par une clé d'API. Utilisez :

Terminal
vercel --api https://api.host.hgdc.ch --token ah_… deploy

Ma variable sensible n'est pas dans vercel pull

C'est voulu : une variable sensible ne part que vers le build du dépôt, par la clé limitée au projet. Depuis votre poste, utilisez une valeur de développement, dans une variable non sensible visant l'environnement Développement. Voir Variables sensibles.

Autre chose ?

Écrivez à contact@smartflowsa.ch avec l'URL du déploiement concerné.