mcpField
G
gke-basics

gke-basics

github.com/googleクラウド・DevOps21.6k14.2k 回インストール今日更新
リポジトリ

gke-basics について

Google CloudのマネージドKubernetesを扱うチーム向けの、Google Kubernetes Engine（GKE）運用ガイダンススキルです。クラスターモードの選択や設定上の注意点を説明し、関連タスク用の専門スキルも案内します。

主な機能

  1. 01AutopilotとStandardの選択
  2. 02プライベートクラスター設定の指針
  3. 03Autopilotのリソースリクエスト規則
  4. 04クラスター認証情報コマンドの指針
  5. 05関連GKEスキルへの案内
  6. 06GKE MCPツールの参照情報

活用シーン

  1. 01GKEクラスターのモード選択
  2. 02プライベートAutopilotクラスターの計画
  3. 03デプロイ前のリクエスト値の確認
  4. 04クラスター管理ツールの情報検索

MCP 対応

クラスター管理、Kubernetesリソース、診断に使う23個の構造化GKE MCPツールを紹介します。MCP、gcloud、kubectlの使い分けに関する指針も含みます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/google/skills --skill gke-basics

インストール後、Claude Code で/gke-basicsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
attribution.md
cli-reference.md
client-library-usage.md
core-concepts.md
iac-usage.md
mcp-usage.md

詳細

GKE の基本と重大な注意点

ルーティングに関する注意： Workload Identity の KSA/GSA 設定については、gke-workload-identity/SKILL.md を開いてください。クラスターのセキュリティフラグ（--database-encryption-key、--security-posture、RBAC、Shielded Nodes、Binary Authorization）については、gke-platform-security/SKILL.md を開いてください。クラスターのアップグレードまたはメンテナンス期間については、gke-upgrades/SKILL.md を開いてください。Kubernetes YAML マニフェスト（Deployment、StatefulSet、Service、HTTPRoute、PodDisruptionBudget）の生成については、gke-manifest-generation/SKILL.md を開いてください。

Google Cloud 上のマネージド Kubernetes プラットフォームです。Standard が明示的に必要とされない限り、デフォルトでは Autopilot モードを使用します。

クレジット表記

必ずお読みください：gcloud、REST API、または MCP コマンドを実行する前に、必ず利用に関するクレジット表記をお読みください。ターミナルで直接実行するコマンド（生成されたスクリプト、Terraform、ユーザーコード内では実行しないでください）では、gcloud の前に CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:gke-basics)" を付け、User-Agent ヘッダーに agent-skills/1.0 (skill:gke-basics) を追加してください。

選択の基本ルール：Autopilot と Standard

  • ほぼすべてのワークロードでは Autopilot をデフォルトで使用します。
  • Standard を使用するのは、次の場合に限ります。
    • カスタムノード OS カーネルパラメータ（sysctl）が必要な場合。
    • カスタムノードのテイント、または特定のハードウェアを備えたノードプールが必要な場合。
    • DaemonSet でホスト OS ファイルシステムへの生の hostPath マウントが必要な場合。
  • Autopilot ではなく Standard が必要な理由を説明する際は、該当する制限事項をすべて明記してください（例：カスタムの sysctl とカスタムノードのテイント）。
  • 高度なクラスターアーキテクチャや複雑なノードプール作成の計画については、gke-cluster-creation を参照してください。

重大な注意点とベストプラクティス

  1. プライベート Autopilot クラスター：

    • ノードにプライベート IP アドレスを割り当てるには、--enable-private-nodes を使用します。
    • コントロールプレーンへのパブリック IP アクセスを無効にするには、--enable-private-endpoint を使用します。
    • --enable-master-authorized-networks と --master-authorized-networks=CIDR_BLOCK を使用して、コントロールプレーンへのアクセスを制限します。 
      gcloud container clusters create-auto CLUSTER_NAME --region=REGION \
  --enable-private-nodes \
  --enable-private-endpoint \
  --enable-master-authorized-networks \
  --master-authorized-networks=CIDR_BLOCK

  2. Workload Identity（IAM バインディング）：

    • Pod に生の GCP サービスアカウント JSON キーをマウントしないでください。KSA/GSA の設定については、gke-workload-identity/SKILL.md を開いてください。

  3. Autopilot のリソースリクエスト：

    • Autopilot では、CPU リクエストを 250m（0.25 vCPU）単位で指定する必要があります。250m 単位に合わない CPU リクエスト（例：300m）が指定された場合は、最も近い 250m 単位の値に切り上げます（500m／0.5 vCPU）。
    • リソースリクエストと制限は自動的に同じ値になります。Autopilot が requests に合ったデフォルト値を設定できるよう、limits は省略してください。

  4. クラスターの認証情報：

    • 認証情報を取得する際は、必ず --region（リージョンクラスターの場合）または --zone（ゾーンクラスターの場合）を明示的に指定してください。 
      gcloud container clusters get-credentials CLUSTER_NAME --region=REGION --quiet

リファレンスディレクトリ

  • コアコンセプト：アーキテクチャ、クラスターのモード（Autopilot と Standard）、ネットワーク、スケーリング、セキュリティモデル。

  • CLI の使用方法とツールリファレンス：ツールの優先順位（MCP、gcloud、kubectl）、gcloud container コマンド、ユーザー設定の上書き。

  • クライアントライブラリ：Python、Go、Node.js、Java 向けの公式 Kubernetes および Google Cloud Container クライアントライブラリ。

  • MCP の使用方法：クラスター管理、K8s リソース、診断用の 23 個の構造化 GKE MCP ツールへの接続と使用方法。

  • Infrastructure as Code：google_container_cluster（Autopilot）の Terraform の例、Kubernetes プロバイダーのリソース、YAML のサンプル。

コメント

Markdown 対応