troubleshooting について
Ludus のデプロイやクライアントの問題を診断するトラブルシューティングスキルです。運用担当者がエラー情報を集め、ログと設定を調べ、対処と復旧確認を進められるよう支援します。
主な機能
- 01体系的な障害切り分け手順
- 02デプロイ状態とログの確認
- 03テンプレートと range 設定の確認
- 04一般的なエラーと原因の対応付け
- 05復旧を確認する手順
活用シーン
- 01Ludus のデプロイ失敗の調査
- 02ネットワークや接続問題の追跡
- 03Ansible やドメイン参加の失敗診断
- 04対処後の復旧確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/troubleshootingを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/common-errors.md
詳細
Ludus のトラブルシューティング
このスキルを使用して、ユーザーから報告された障害を迅速にトリアージし、エラーを分類して、的を絞った修正手順を提示します。
診断ワークフロー
- 状況とエラー出力の正確な内容を収集します。
- レンジのデプロイ状態と直近のエラーを確認します。
- デプロイログを確認して、障害の詳細を調べます。
- 既知のエラーカタログを使用して、障害のカテゴリーを特定します。
- 現在のレンジ設定を調べ、設定ミスがないか確認します。
- 具体的な手順を含む、的を絞った修正方法を提示します。
- 復旧を確認するための明確な検証手順を定めます。
主な診断情報
トリアージの際は、有用性の高い順に次の情報を収集します。
- レンジの状態 — デプロイは実行中、失敗、完了のいずれですか？
- デプロイエラー — 直近のデプロイで出力されたエラー。
- デプロイログ — 障害の状況を追跡するためのログ全体。
- テンプレートの状態 — 必要なテンプレートはビルド済みで、利用可能ですか？
- レンジ設定 — YAML はユーザーの意図どおりですか？
- テストモードの状態 — テストモードは有効ですか？ネットワークルールは適用されていますか？
よくあるパターン
- ネットワークの問題は、dnsmasq または NAT ブリッジの状態に起因することがよくあります。
- Ansible の失敗は、多くの場合、WinRM（Windows）または SSH の到達性（Linux）に関係しています。
- ドメイン参加の失敗は、通常、DNS の順序やタイミングに関係しています。
- テンプレートの失敗は、ISO のダウンロードまたはディスク容量が原因であることがよくあります。
参考資料
- 既知のエラー、根本原因、修正手順については、
references/common-errors.mdを使用してください。 - クライアントと CLI のトラブルシューティングの詳細については、
https://docs.ludus.cloud/docs/troubleshooting/clientを使用してください。 - ネットワークと接続の問題については、
https://docs.ludus.cloud/docs/troubleshooting/network/およびhttps://docs.ludus.cloud/docs/troubleshooting/wireguard/を使用してください。 - Ludus をアンインストールする場合は、自分で手順を実行するのではなく、公式ガイド
https://docs.ludus.cloud/docs/troubleshooting/uninstallをユーザーに案内してください。
コメント
Markdown 対応