トラブルシューティング

再試行前にエラーと操作報告で完了済みの手順を確認してください。エラーは以前の変更が元に戻ったことを意味しません。

接続と権限のエラー

管理者 kubeconfig、コンテキスト、API サーバーのアドレス、クラスターへのネットワーク接続を確認してください。CLI で --kubeconfig と --context を明示するか、TUI でコンテキストを選び直してください。

Forbidden エラーでは管理者権限を確認してください。バインディング作成には追加の RBAC 認可が必要な場合があり、dry-run にも権限が必要です。ライセンス有効化ではクラスターの権限不足は解消しません。

既存ファイルやシンボリックリンクは上書きしません。CLI では --output で新しいファイル名を指定してください。TUI では書込可能な既存ディレクトリを選び、確認画面でパスを確認します。受取人用 kubeconfig は管理者設定と分けてください。

状況	次の対応
リソース作成後に発行失敗	報告を読み、`kticket list` と `kticket access list` で残存アカウント・権限を確認してください。
トークン発行後の手順が失敗	まず報告を確認してください。TUI で「要確認」のアカウントは自動再試行から除外されます。
一括処理が途中停止	同じセッションで r を押すと失敗・待機中アカウントを再確認します。成功済みは除外します。終了後に一括処理は復元できません。
権限変更が部分的に失敗	アカウントを再読込して新しい計画を作成してください。完了済みの変更は戻りません。
認証情報の履歴が読取不能・満杯	エラーを保存し、再発行前にクラスター管理者へ記録の確認を依頼してください。記録削除ではトークンは失効しません。

発行失敗時は未完成の出力ファイルを削除しようとし、削除エラーを報告します。アカウント・名前空間・権限の変更は残る場合があります。ファイルを削除してもトークンが発行済みの可能性があります。全認証情報の無効化にはアカウントを失効させてください。

1 つの権限削除ではアカウントや外部バインディングの権限は削除しません。kticket access check で操作が引き続き許可されるか確認してください。

失効は全認証情報に影響しますが、既存接続は終了しません。アカウント削除後のバインディング削除に失敗したら、管理者権限で残存バインディングを確認してください。同名アカウントの再作成前に削除を完了し、共有ロールや他のアカウントのバインディングは削除しないでください。

kticket license status で状態、現在のマシン ID、ライセンスファイルの場所を表示します。

状況	次の対応
ライセンスメールが届かない	購入時のメールアドレスと迷惑メールを確認し、注文情報を添えてお問い合わせください。
ライセンスが見つからない	kticket を実行するユーザーで添付ファイルをインストールし、`KTICKET_LICENSE_FILE` がインストール時と同じか確認してください。
インストール時に上書きが拒否される	意図的に置き換える場合は `kticket license install --force FILE` を使用してください。
`wrong machine`	現在のマシン ID と購入時の値を比較し、ハードウェア変更時はお問い合わせください。
無効・破損したファイル	元のメールから未編集の添付ファイルを復元し、解決しなければお問い合わせください。
不明な署名鍵	kticket を更新して再試行してください。最新版ならお問い合わせください。

詳しいインストール手順はライセンスの購入とアクティベーションをご覧ください。

サポートページから、kticket のバージョン、OS、コマンド、エラーをお知らせください。決済・ライセンスの問題は注文番号とマシン ID も添えてください。公開・メール共有前にトークン、管理者 kubeconfig、その他の認証情報を削除してください。