Dépannage

Des correctifs pratiques pour les problèmes que vous risquez le plus de rencontrer.

Échecs d’authentification

Si une commande renvoie une erreur d’authentification, confirmez quelle identité (le cas échéant) la CLI résout :

suya auth whoami     # calls the API and prints the resolved identity
suya auth status     # local auth status, no server call

Pour les agents et la CI, assurez-vous que SUBAYA_API_KEY est exportée dans le shell qui exécute suya :

echo "${SUBAYA_API_KEY:?SUBAYA_API_KEY is not set}"

Souvenez-vous de la précédence des identifiants : l’indicateur --token l’emporte, puis SUBAYA_API_KEY, puis le jeton OAuth stocké localement. Si vous vous êtes connecté il y a longtemps, un nouveau suya auth login rétablit le jeton local. Voir Authentification et clés d’API.

Les commandes atteignent le mauvais hôte

Chaque commande dialogue avec https://subaya-dev.com par défaut. Si des requêtes échouent ou aboutissent à un endroit inattendu, vérifiez que vous n’avez pas passé un --host parasite :

suya auth whoami --host https://subaya-dev.com

Ne remplacez --host que lorsque vous avez l’intention de cibler un point d’accès d’API non par défaut.

suya sim run ne trouve pas le banc d’essai

Le chemin --tb est interprété au sein de l’arborescence --source, non par rapport au répertoire de travail de votre shell. Si l’exécution signale un banc d’essai manquant, vérifiez que le chemin se résout à l’intérieur du répertoire source que vous téléversez :

suya sim run --source . --tb tb/top_tb.sv --top top --tool ryusim

Deux choses à vérifier :

• Le chemin --tb existe sous le répertoire --source.
• L’arborescence --source fait 4 Mo ou moins — élaguez les artefacts de build et les gros fichiers binaires avant de soumettre.

Voir CLI : sim pour la surface complète de simulation.

suya repo connect / repo create échoue

Les deux commandes repo exigent l’installation id de la GitHub App via --installation :

suya repo connect --installation <id> --owner <o> --repo <r>
suya repo create  --installation <id> --name <n>

Si vous n’avez pas encore d’installation id, installez d’abord la GitHub App — voir Connecter un dépôt GitHub. Confirmez l’état actuel de la connexion avec :

suya repo status

CLI obsolète

Si une commande ou un indicateur est absent, ou si le comportement ne correspond pas à cette documentation, votre CLI est peut-être obsolète. Vérifiez et mettez à jour :

suya version            # show version metadata
suya update --check     # report whether a newer release exists
suya update             # upgrade to the latest release

Toujours bloqué ?

• Relancez avec -v/--verbose pour des diagnostics supplémentaires, ou --json pour une sortie exploitable par une machine.
• Vérifiez l’état du service sur la page Statut.
• Parcourez la surface complète des commandes dans la Référence de la CLI.