Documentation0.0.1
Recherche locale · Aucun contenu envoyé à un service externe esc
GitHub
RessourcesRAPIDOS 0.0.1

Dépannage

Les erreurs fréquentes, leur cause et la prochaine action.

La commande rapidos est introuvable#

Vérifiez que l’installation globale s’est terminée, puis que le dossier des exécutables npm est dans le PATH. Vous pouvez essayer l’aperçu avec npx depuis le guide d’installation.

Le registre retourne 401 ou 403#

Vérifiez l’URL npm-public-install pour télécharger. Si l’accès public n’est pas encore autorisé, le mainteneur doit corriger les rôles anonymes dans Nexus. Ne partagez jamais votre jeton dans une issue.

Aucun script de lancement valide#

Le projet n’a pas de script dev, start ou serve. Consultez ses scripts et utilisez --script NOM. Pour une bibliothèque, --install-only peut être le mode approprié.

Gestionnaires en conflit#

Plusieurs verrouillages ou un champ packageManager contradictoire empêchent un choix fiable. Identifiez le gestionnaire utilisé par l’équipe, puis alignez le manifeste et les fichiers de verrouillage.

L’installation verrouillée échoue#

Le manifeste et le verrouillage peuvent être désynchronisés. Reproduisez la commande affichée avec le gestionnaire du projet et corrigez le verrouillage. Rapidos ne contourne pas le mode verrouillé.

Le téléchargement Node ou Java échoue#

Vérifiez le réseau, l’espace disque et les droits du cache. Vérifiez aussi la disponibilité de la version pour votre plateforme et la présence de tar ou PowerShell. Une archive dont le checksum ne correspond pas est rejetée.

Le build Java ne démarre pas#

Vérifiez que le wrapper est exécutable et que le goal ou la tâche existe. Une version Java explicite peut être nécessaire. Les profils, plugins hérités ou conventions complexes ne sont pas tous détectés statiquement.

La session est running mais rien ne répond#

Le processus peut encore installer des dépendances, compiler, attendre un service ou échouer lors de son initialisation. Consultez get_logs. Rapidos n’effectue pas de vérification HTTP automatique de disponibilité.

Signaler un problème#

Dans les issues GitHub, indiquez le système et l’architecture, rapidos --version, node --version, le type de projet, la commande exécutée et des logs expurgés des secrets. Un exemple minimal reproductible permet de diagnostiquer plus rapidement.