CLI Fehlerbehebung

Beginnen Sie mit einer Reihe einfacher lokaler und authentifizierter Überprüfungen:

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

Fügen Sie keine SchlüsselAPI, Browser-Token, Webhook-Geheimnisse oder ungeschwärzte Debug- Ausgaben in eine Supportanfrage ein.

Befehl nicht gefunden

Vergewissern Sie sich, dass die ausführbare Datei vorhanden ist und sich unter PATH:

command -v champrep
echo "$PATH"

Der Direktinstallierer verwendet normalerweise $HOME/.local/bin für einen Nicht-Root-Benutzer. Fügen Sie dieses Verzeichnis zur Startdatei der Shell hinzu und öffnen Sie ein neues Terminal. Falls mehrere Instanzen installiert sind, entfernen Sie die ältere oder setzen Sie das gewünschte Verzeichnis an die erste Stelle in PATH.

Die Browser-Anmeldung lässt sich nicht öffnen

Verwenden Sie die „Headless“-Genehmigung:

champrep auth login --no-browser

Öffnen Sie die angezeigte URL in einem vertrauenswürdigen Browser. Wenn die Autorisierung abläuft, starten Sie eine neue Anmeldung, anstatt die alte URL erneut zu verwenden.

Authentifizierung erforderlich oder ungültig

champrep auth list
champrep auth whoami

Prüfen Sie, ob CHAMPREP_TOKEN ist festgelegt. Er überschreibt den Schlüsselbund für den aktuellen Prozess und kann dazu führen, dass die andere Anmeldedaten als erwartet CLIverwendet.

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

Geben Sie den Wert nicht aus. Erneuern Sie die Browser-Anmeldung oder ersetzen Sie gegebenenfalls einen widerrufenen Automatisierungsschlüssel .

Falsches Konto, falsches Profil oder falsche Umgebung

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

Ein Profilwechsel erfolgt innerhalb eines Kontos, das auf dem Rechner bereits authentifiziert ist. Authentifizieren Sie sich separat, um ein anderes Konto hinzuzufügen.

Unzureichender Geltungsbereich oder Zugriff verweigert

Die Anmeldedaten können gültig sein, während die Anfrage aufgrund ihres Geltungsbereichs, des aktiven Tarifs, der Dienstverfügbarkeit, der Unternehmensrichtlinie, der Rolle oder der Ressourcenberechtigung abgelehnt wird.

Ausführen champrep auth status.
Ermitteln Sie den für den Befehl erforderlichen Dienstumfang.
Überprüfen Sie den Schlüssel im Dashboard „SchlüsselAPI“.
Vergewissern Sie sich, dass das aktive Profil dieselbe Aktion in der Benutzeroberfläche des Dienstes ausführen kann.
Erstellen Sie einen Schlüssel mit dem geringstmöglichen Berechtigungsumfang oder wechseln Sie zu einem solchen Schlüssel, sofern die Arbeitslast dazu berechtigt ist.

Ratenbegrenzung

Exit-Code 5 bedeutet, dass ein aktuelles Gateway-Limit erreicht wurde. Warten Sie die angegebene Wiederholungsdauer ab, reduzieren Sie parallele Vorgänge und vermeiden Sie häufiges Abfragen. Limits richten sich nach der aktuellen Kontokonfiguration; lassen Sie ein Skript keine feste Zahl für einen Tarifnamen annehmen.

Netzwerk- oder Dienstausfall

Verwenden Sie zunächst eine ausführliche Ausgabe, die ausschließlich Metadaten enthält:

champrep --verbose auth whoami

--debug kann Anfrage- oder Antwortinhalte enthalten. Verwenden Sie diese nur in einer kontrollierten Umgebung und überprüfen Sie die Ausgabe, bevor Sie sie weitergeben.

Überprüfen Sie die Einstellungen für DNS, Proxy, Firewall und TLS-Prüfung. Der CLImuss den CHAMPREP überAPI Gateway HTTPS erreichen. CHAMPREP_API_URLmuss, wenn er für Entwicklungszwecke verwendet wird, einen Gateway-kompatiblen Endpunkt und keinen einzelnen Dienst identifizierenAPI.

Für 502, 503oder 504, wiederholen Sie einen sicheren Lesevorgang mit begrenzter Wartezeit. Wiederholen Sie keinen Erstellungs-, Aktualisierungs-, Sende- oder Löschvorgang, bis Sie wissen, ob die erste Anfrage wirksam war.

Erstellen Sie einen sicheren Supportbericht

Bitte fügen Sie Folgendes ein:

champrep version Ausgabe;
Betriebssystem und Architektur;
den Befehlsnamen, wobei sensible Argumente entfernt wurden;
den Namen der ausgewählten Umgebung;
den Exit-Code;
den HTTP-Status und den stabilen Fehlercode;
die ungefähre Uhrzeit und Zeitzone des Fehlers.

Schließen Sie Anmeldedaten und sensible Inhalte aus. Wenden Sie sich anschließend an CHAMPREP Support.