コンテンツにスキップ
CHAMPREPCHAMPREPCHAMPREP Docs

CLI トラブルシューティング

まずは、ローカルおよび認証に関する基本的なチェックから始めてください：

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

サポートリクエストには、キーAPI、ブラウザトークン、Webhookのシークレット、または非公開部分が削除されていないデバッグ 出力を貼り付けないでください。

コマンドが見つかりません

Section titled “コマンドが見つかりません”

バイナリが存在し、以下のパスにあることを確認してください： PATH:

Terminal window
command -v champrep
echo "$PATH"

ダイレクトインストーラは通常、 $HOME/.local/bin 非rootユーザーでは開けません。 そのディレクトリをシェルの起動ファイルに追加し、新しいターミナルを開いてください。複数の コピーがインストールされている場合は、古い方を削除するか、目的のディレクトリを の先頭に配置してください。 PATH.

ブラウザでのログイン画面が開かない

Section titled “ブラウザでのログイン画面が開かない”

ヘッドレス承認を使用する場合：

Terminal window
champrep auth login --no-browser

表示されたURLを信頼できるブラウザで開いてください。承認が期限切れになった場合は、 古いURLを再利用するのではなく、新しい ログインを開始してください。

認証が必要、または無効

Section titled “認証が必要、または無効”
Terminal window
champrep auth list
champrep auth whoami

以下を確認してください CHAMPREP_TOKEN が設定されている場合、現在の プロセスのキーチェーンを上書きし、 が想定とは異なる認証情報を使用CLIする原因となる可能性があります。

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

値を表示しないでください。必要に応じて、ブラウザのログイン情報を更新するか、失効した自動化キーを 交換してください。

アカウント、プロファイル、または環境が間違っています

Section titled “アカウント、プロファイル、または環境が間違っています”
Terminal window
champrep auth list
champrep auth switch PROFILE
champrep config env
champrep --env production auth whoami

プロファイルの切り替えは、そのマシンですでに認証済みのアカウント内で行われます。 別のアカウントを追加する場合は、別途認証を行ってください。

スコープが不十分、またはアクセスが拒否されました

Section titled “スコープが不十分、またはアクセスが拒否されました”

資格情報は有効であっても、スコープ、有効な プラン、サービスの可用性、組織のポリシー、ロール、またはリソースの権限によってリクエストが拒否される場合があります。

  1. 実行 champrep auth status.
  2. コマンドに必要なサービススコープを特定してください。
  3. 「KeysAPI」ダッシュボードでキーを確認してください。
  4. サービス UI で、アクティブなプロファイルが同じアクションを実行できることを確認してください。
  5. ワークロードが当該スコープを持つ権限を有している場合は、 欠落しているスコープを含む最小権限のキーを作成するか、またはローテーションを行ってください。

レート制限

Section titled “レート制限”

終了コード 5 は、現在のゲートウェイの制限に達したことを意味します。指定された 再試行期間を待ち、並行処理を減らし、頻繁なポーリングは避けてください。制限は 現在のアカウント設定によって決定されます。スクリプト内で、プラン名に対して固定の 数値を想定するような設定は行わないでください。

ネットワークまたはサービスの障害

Section titled “ネットワークまたはサービスの障害”

まずはメタデータのみの詳細出力を使用してください：

Terminal window
champrep --verbose auth whoami

--debug には、リクエストまたはレスポンスの本文が含まれる場合があります。管理された 端末でのみ使用し、共有する前に出力を確認してください。

DNS、プロキシ、ファイアウォール、および TLS インスペクションの設定を確認してください。 は、 CHAMPREP に HTTPS 経由API Gatewayで接続できるCLI必要があります。 CHAMPREP_API_URL開発用途で利用する場合、 個別のサービスではなく、Gateway 互換のエンドポイントを指定する必要がありますAPI。

については、 502, 503、または 504、制限付きのバックオフを設定して安全な読み取りを再試行してください。最初のリクエストが 有効になったかどうかが判明するまでは、 作成、更新、送信、または削除を繰り返さないでください。

安全なサポートレポートを収集する

Section titled “安全なサポートレポートを収集する”

以下の内容を含めてください：

  • champrep version 出力；
  • オペレーティングシステムおよびアーキテクチャ；
  • 機密性の高い引数を削除したコマンド名；
  • 選択した環境名；
  • 終了コード；
  • HTTPステータスおよび安定したエラーコード；
  • 障害が発生したおおよその時刻とタイムゾーン。

認証情報や機密情報を除外してください。その後、 CHAMPREP サポート.