CLI Dépannage

Commencez par effectuer une série de vérifications locales et d’authentification :

champrep version
champrep config path
champrep config env
champrep auth whoami
champrep auth status

Ne collez pas de clésAPI, de jetons de navigateur, de secrets de webhook ou de sorties de débogage non expurgées dans une demande d’assistance.

Commande introuvable

Vérifiez que le fichier binaire existe et se trouve dans PATH:

command -v champrep
echo "$PATH"

Le programme d’installation direct utilise normalement $HOME/.local/bin pour un utilisateur non root. Ajoutez ce répertoire au fichier de démarrage du shell et ouvrez un nouveau terminal. Si plusieurs copies sont installées, supprimez la plus ancienne ou placez le répertoire souhaité en premier dans PATH.

La page de connexion via le navigateur ne s’ouvre pas

Utilisez l’approbation « headless » :

champrep auth login --no-browser

Ouvrez l’URL affichée dans un navigateur de confiance. Si l’autorisation expire, effectuez une nouvelle connexion plutôt que de réutiliser l’ancienne URL.

Authentification requise ou non valide

champrep auth list
champrep auth whoami

Vérifiez si CHAMPREP_TOKEN est défini. Il remplace le trousseau de clés du processus en cours et peut amener le à CLIutiliser des identifiants différents de ceux prévus.

test -n "$CHAMPREP_TOKEN" && echo "ephemeral token override is active"

N’affichez pas la valeur. Renouvelez votre connexion au navigateur ou remplacez une clé d’automatisation révoquée selon le cas.

Compte, profil ou environnement incorrect

champrep auth list
champrep auth switch PROFILE
champrep config env
champrep --env production auth whoami

Un changement de profil s’effectue au sein d’un compte déjà authentifié sur la machine. Authentifiez-vous séparément pour ajouter un autre compte.

Portée insuffisante ou accès refusé

Les identifiants peuvent être valides alors même que la requête est refusée en raison de son périmètre, de son forfait actif, de la disponibilité du service, de la politique de l’organisation, du rôle ou des autorisations sur les ressources.

1. Exécuter champrep auth status.
2. Identifiez la portée de service requise par la commande.
3. Vérifiez la clé dans le tableau de bord « ClésAPI ».
4. Vérifiez que le profil actif peut effectuer la même action dans l’interface utilisateur du service.
5. Créez ou effectuez une rotation vers une clé à privilèges minimaux avec la portée manquante lorsque la charge de travail est autorisée à en disposer.

Limitation de débit

Code de sortie 5 signifie qu’une limite actuelle de Gateway a été atteinte. Attendez la période de réessai indiquée, réduisez le nombre de tâches parallèles et évitez les interrogations fréquentes. Les limites sont déterminées par la configuration actuelle du compte ; ne faites pas en sorte qu’un script suppose un nombre fixe pour un nom de forfait.

Panne du réseau ou du service

Utilisez d’abord une sortie détaillée contenant uniquement des métadonnées :

champrep --verbose auth whoami

--debug peut inclure des corps de requête ou de réponse. Utilisez-le uniquement sur un terminal contrôlé et vérifiez la sortie avant de la partager.

Vérifiez les paramètres DNS, proxy, pare-feu et d’inspection TLS. Le CLIdoit atteindre le CHAMPREP viaAPI Gateway HTTPS. CHAMPREP_API_URL, lorsqu’il est utilisé à des fins de développement, doit identifier un point de terminaison compatible avec la passerelle et non un service individuelAPI.

Pour 502, 503, ou 504, réessayez une lecture sécurisée avec un délai d’attente limité. Ne répétez pas une opération de création, de mise à jour, d’envoi ou de suppression tant que vous ne savez pas si la première requête a pris effet.

Collectez un rapport d’assistance sécurisé

Veuillez inclure :

• champrep version sortie ;
• système d’exploitation et architecture ;
• le nom de la commande dont les arguments sensibles ont été supprimés ;
• le nom de l’environnement sélectionné ;
• le code de sortie ;
• le statut HTTP et le code d’erreur stable ;
• l’heure approximative et le fuseau horaire de la défaillance.

Excluez les identifiants et les contenus sensibles. Contactez ensuite CHAMPREP Assistance.