olares-doctor

doctor（ランタイム診断）

共通の入口： スイート内のルーティング、アクティブなプロファイルの選択、プラットフォームのエントリーポイント、認証の続行／停止ゲートについては、../olares-shared/SKILL.md を読み込んでください。ログイン、プロファイルの切り替え、トークンの保存、認証の復旧が実際に必要な場合に限り、認証リファレンスを読み込んでください。

このスキルは、Market、Cluster、Dashboard を対象とする軽量な診断ルーターです。ライフサイクルの状態、TTL、シリアル化されたダウンロード、running を解釈する際は、共通のアプリケーション状態モデルを読み込んでください。構文については、olares-cli doctor <verb> --help を使用してください。

使用する状況

• インストール／アップグレードが止まっている、または running に到達しない。アプリが起動しない。
• アプリがクラッシュする／繰り返し再起動する（CrashLoopBackOff、終了コード、設定エラー）。
• イメージをプルできない（ImagePullBackOff／ErrImagePull／アーキテクチャの不一致）、または未使用のローカルイメージを確認したい。
• アプリが running だが、エントランスにアクセスできない／エラーになる／タイムアウトする。
• システムまたはアプリの動作が遅い、あるいは GPU／リソースのバインドが拒否される（node-pressure）。

カタログアプリ（market でインストール）と独自の開発アプリ（chart でデプロイ）の両方で、ランタイム障害はこちらに振り分けられます。 根本原因が判明したら、自作の開発アプリの修正は通常チャートの編集になるため、../olares-chart/SKILL.md に引き継いでください。

基本的な考え方： doctor は「なぜ壊れていて、次に何をすればよいか」を診断します。診断はデフォルトで読み取り専用です。唯一の変更操作は、明示的に承認された thirdleveldomain --force-dedupe による修復です。開発からデプロイ、デバッグまでの4つのスキルの組み合わせは、chart + market + olares-shared + doctor です。

症状からのルーティング

症状	リファレンス
インストール／アップグレードが止まっている、running に到達しない、pending／downloading／installing／initializing のまま、新規インストールが stopped で終了した	references/olares-doctor-app-stuck.md
アプリがクラッシュする／再起動する（CrashLoopBackOff、ゼロ以外の終了コード、CreateContainerConfigError、権限エラー）	references/olares-doctor-app-crash.md
イメージをプルできない（ImagePullBackOff／ErrImagePull／InvalidImageName／アーキテクチャの不一致）、未使用のローカルイメージの確認	references/olares-doctor-image.md
アプリが running だが、エントランスにアクセスできない／5xx が発生する／タイムアウトする／画面が空白になる	references/olares-doctor-running-unhealthy.md
システムまたはアプリの動作が遅い、リソース不足、GPU／コンピューティングのバインドが拒否される（node-pressure）	references/olares-doctor-resources.md

設定済みのモデルが応答しない場合は、まず一つ上のレイヤーで診断してください。olares-router は、ゲートウェイ、そのアクセス制御、モデルアプリ自体のダウンロード／エンジンの状態を、ここで扱う Pod レベルの障害と切り分けます。原因がアプリケーションより下位にある場合は、こちらに振り分けます。

まず、通常のキュー処理ではないか確認してください。 インストールが止まっていると判断する前に、別のアプリが downloading になっていないか確認してください。app-service は一度に1つのダウンロードのみを実行するため、pending の行は単にキューで待機中であることがよくあります（appstate リファレンスと app-stuck リファレンスを参照）。

動詞の一覧

コマンド	目的	該当する場合に読むもの
images	ワークロードからの参照情報を付加した、ローカルイメージの完全な一覧。未使用候補の確認	イメージの診断
thirdleveldomain	重複／予約済みの第3レベルドメインを監査。修復は任意	ドメインの監査と修復

doctor がエビデンスを収集する方法（所有ではなくオーケストレーション）

• ライフサイクルの状態／ソースは、olares-market から取得します。
• Pod、イベント、ログ、ワークロードは、olares-cluster から取得します。
• 圧力と使用率は、olares-dashboard から取得します。
• 名前空間の検出には、共有のプラットフォームモデルに従います。

時刻とオブジェクトの所有関係に基づいてエビデンスを関連付けます。Market のタイムアウトは失敗ではありません。running が証明するのは入口の TCP 到達可能性だけです。新規インストールでは、スケジューリングの失敗後に *Failed のライフサイクル状態にならず、stopped に落ち着く場合があります。

安全性とエスカレーション

• 診断はデフォルトで読み取り専用です。自動診断の手順として、再起動、削除、スケール変更、キャンセル、プルーニング、チャートの編集を行わないでください。
• thirdleveldomain --force-dedupe は Application リソースを変更します。変更案を提示し、事前に明示的な承認を得てください。
• 未使用イメージのレポートはエビデンスであり、イメージを削除する許可ではありません。
• システム名前空間のエビデンスの確認には、通常、管理者の可視性が必要です。403／404 の場合は、アプリ独自のエビデンスを使用し、可視性が不足していることを報告してください。承認なしに ID を切り替えないでください。
• アプリ／ユーザー／名前空間が曖昧な場合、必要なログの確認により高いロールが必要な場合、または修正がチャートの編集、ライフサイクルの変更、ホスト管理に踏み込む場合は、そこで停止してください。