kubernetes

Kubernetes

このスキルは、判断とルーティングのレイヤーとして使用してください。固定的な kubectl チートシートとして扱わないでください。

運用上の契約

1. 対象を特定します：ディストリビューション、プロバイダー、クラスターのバージョン、クライアントのバージョン、コンテキスト、名前空間、アクセスモード、クラスターが本番環境かどうか。
2. 推測する前に確認します：提供されている API リソース、API バージョン、CRD、システムワークロード、ノード、ディストリビューションを示す情報を照会します。
3. ポータブルな Kubernetes の動作と、ディストリビューション／プロバイダー固有の上書き設定を分けます。ライフサイクル、ネットワーク、ID、ストレージ、アップグレードの手順を使用する前に、該当するリファレンスを読み込みます。
4. 変更を加える場合は、まずプレビュー（k8s-cli ... --dry-run または kubectl diff／サーバー側ドライラン）を行い、対象範囲を明示し、破壊的な操作には明示的な確認を必須としたうえで、条件、イベント、ロールアウト、外部との境界を検証します。
5. 安定版 API とサーバー側の検証を優先します。ベータ版／アルファ版 API、機能ゲート、プロバイダーのデフォルト設定、バージョン番号は、時期によって変わるものとして扱います。
6. 証拠は範囲を限定し、構造化して保持します。kubeconfig、Secret の値、トークン、または範囲を限定しないログをチャットに出力しないでください。

運用経路の選択

状況	最初に行うこと	してはいけないこと
稼働中のクラスターを操作する	doctor、context、discover を実行し、コンテキスト、名前空間、ディストリビューション、バージョンを記録します	設定や以前のコマンドからクラスターの状態を推測しないでください
クラスターにアクセスできない	範囲を限定した計画を提示し、不足している前提条件を明示します	診断結果や成功を断言したり、実行していないコマンド出力を捏造したりしないでください
変更を加える場合	レンダリングし、diff／サーバー側ドライランを行い、対象範囲を明示し、必要な確認を得てから変更し、該当する境界を検証します	コマンドの終了コードが 0 であることを、運用上の成功とみなさないでください
プロバイダーまたはディストリビューションが存在する	ポータブルなガイダンスを適用する前に、該当するオーバーレイを読み込みます	上流の手順を変更せずに適用しないでください

最初の応答での確認

scripts/k8s-cli --json doctor
scripts/k8s-cli --json context
scripts/k8s-cli --json discover

ラッパーが利用できない場合は、references/cli-reference.md にある同等のネイティブコマンドを使用します。kubectl がない場合は、前提条件が満たされていないことを報告して停止し、クラスターの状態を捏造しないでください。

ルーティング

シナリオ	読み込むもの
API の検出、SSA、CRD、非推奨化	references/api-and-versioning.md
ワークロード、プローブ、ロールアウト、ジョブ、コントローラー	references/workloads-and-rollouts.md
スケジューリング、スケーリング、ストレージ、ノードの中断、信頼性	references/scheduling-scaling-storage.md および references/nodes-and-reliability.md
サービス、DNS、NetworkPolicy、Ingress、Gateway API	references/networking.md
Pod が Running だがトラフィックを処理していない、または Service エンドポイントに存在しない	references/workloads-and-rollouts.md、references/networking.md、references/troubleshooting.md、および該当するディストリビューションオーバーレイ
RBAC、Pod Security、アドミッション、監査、シークレット、ポリシーエンジン	references/security-and-policy.md および references/policy.md
証拠を優先する診断または高度なデバッグ	references/troubleshooting.md および references/debugging.md
バックアップ、アップグレード、HA、オブザーバビリティ	references/operations.md、references/backup-restore.md、および references/observability.md
ディストリビューション／プロバイダーのオーバーレイまたはバージョンマトリックス	references/distributions.md、references/version-skew.md、および references/source-index.md
ネイティブコマンドの詳細または出力の契約	references/cli-reference.md
変更の安全性を確保するためのゲート	references/safety-gates.md

テンプレートとスクリプト

• templates/diagnostic-report.md：人が読めるインシデントレポート
• templates/cluster-inventory.json：範囲を限定したインベントリスキーマ
• templates/upgrade-runbook.md：事前確認、変更、検証のランブック
• scripts/k8s-cli：エージェントを優先した kubectl のラッパー
• scripts/test-k8s-cli.sh：偽の kubectl を使用した決定的なテスト
• scripts/gather-cluster-state.sh：インシデントレポート向けの範囲を限定した診断情報の収集
• scripts/verify-cluster-health.sh：操作後の範囲を限定したヘルス検証
• scripts/refresh-version-matrix.sh：日付付きのリリース情報を更新します。ガイダンスを黙って編集することはありません

バージョンポリシー

調査の基準日は 2026-07-11 です。Kubernetes プロジェクトのページでは、保守対象のマイナーバージョンとして 1.36、1.35、1.34 が報告されていました。これは恒久的な主張ではありません。現行バージョンやサポート状況を述べる前に、references/distributions.md とソースインデックスを更新してください。

検証の境界

主張	最低限必要な証拠
Pod は正常です	Pod の状態条件、準備状態、イベント、および関連する EndpointSlice または外部の境界
Pod はトラフィックを処理しています	Ready 条件、Service セレクター、EndpointSlice への所属、イベント、および範囲を限定した Service レベルの確認
ロールアウトは成功しました	コントローラーの状態条件、作成された Pod、イベント、および関連する Service または外部チェック
API／リソースは利用可能です	提供されている API の検出、インストール済みの CRD／コントローラーのサポート、およびサーバー側の検証
コマンドは運用上成功しました	範囲を限定したコマンド結果に加え、リソースの状態条件とユーザーが確認できる境界

コンポーネントレベルのコマンド結果が証拠となるのは、そのコンポーネントについてのみです。これをクラスターや統合に関する主張へと拡大しないでください。

厳守すべき制約

• Secret データや生の kubeconfig 認証情報を決して公開しないでください。
• 範囲を説明し、必要な確認を得ることなく、--force-conflicts、delete、drain、patch、upgrade、またはクラスターのリセット手順を決して使用しないでください。
• Running だけを根拠に Pod を healthy と判断しないでください。
• コンポーネントレベルのテストだけを根拠に統合の成功を判断しないでください。
• オーバーレイを読み込まずに、k3s、RKE2、マネージドプロバイダー、Talos、または OpenShift にアップストリームの手順を適用しないでください。