Communitygithub.com

google/gke-basics

Planifiez, créez et configurez des clusters Google Kubernetes Engine (GKE) prêts pour la production en utilisant la configuration Autopilot de la voie dorée. Couvre la liste de contrôle du jour 0, Autopilot vs Standard, le réseau (clusters privés, VPC natif, API Gateway), la sécurité (Workload Identity, Secret Manager, renforcement RBAC), l'observabilité, la mise à l'échelle, l'optimisation des coûts et l'inférence IA/ML.

Qu'est-ce que gke-basics ?

Ce skill fournit un guide complet pour la planification, la création et la configuration de clusters Google Kubernetes Engine (GKE) prêts pour la production, en mettant l'accent sur la configuration Autopilot de la voie dorée. Il est particulièrement utile pour les ingénieurs DevOps et les développeurs qui souhaitent déployer des clusters GKE robustes, sécurisés et optimisés en termes de coûts. Le skill aborde des sujets essentiels comme le choix entre Autopilot et Standard, la configuration réseau avancée (clusters privés, VPC natif, API Gateway), la sécurité (Workload Identity, Secret Manager, renforcement RBAC), l'observabilité via Cloud Monitoring et Logging, la mise à l'échelle automatique, et l'optimisation des coûts. De plus, il guide sur des cas d'utilisation avancés tels que l'inférence IA/ML, la multi-location, le batch computing et le HPC. Le skill est conçu pour être utilisé avec Claude Code, Codex ou Cursor, fournissant des instructions détaillées sous forme de listes de contrôle, de guides de planification et de configurations YAML prêtes à l'emploi pour chaque aspect du cycle de vie d'un cluster GKE.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/google/skills/tree/main/skills/gke-basics

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait gke-basics ?

Planifiez, créez et configurez des clusters Google Kubernetes Engine (GKE) prêts pour la production en utilisant la configuration Autopilot de la voie dorée. Couvre la liste de contrôle du jour 0, Autopilot vs Standard, le réseau (clusters privés, VPC natif, API Gateway), la sécurité (Workload Identity, Secret Manager, renforcement RBAC), l'observabilité, la mise à l'échelle, l'optimisation des coûts et l'inférence IA/ML. UTILISER QUAND : créer un cluster GKE, provisionner un environnement GKE, concevoir le réseau GKE, sécuriser GKE, optimiser les coûts GKE, mise à l'échelle automatique GKE, inférence GKE, mise à niveau GKE, observabilité GKE, multi-location GKE, batch GKE, HPC GKE, classe de calcul GKE.

Pour commencer

Ce skill vous guide à travers le processus de planification et de création d'un cluster GKE prêt pour la production. Avant de commencer, assurez-vous d'avoir :

  • Un projet Google Cloud Platform (GCP) avec la facturation activée
  • Les API Kubernetes Engine et Cloud Resource Manager activées
  • gcloud CLI installé et configuré
  • Les autorisations IAM nécessaires : roles/container.admin et roles/iam.serviceAccountAdmin

Liste de contrôle du jour 0

  • Déterminer le mode de fonctionnement : Autopilot ou Standard
  • Choisir une région et une zone de disponibilité
  • Planifier l'adressage IP du cluster (plages de pods, de services et de nœuds)
  • Activer les fonctionnalités réseau : VPC natif, cluster privé, maillage de services
  • Configurer l'authentification et l'autorisation : Workload Identity, RBAC
  • Intégrer Secret Manager pour la gestion des secrets
  • Activer la surveillance et la journalisation : Cloud Monitoring, Cloud Logging
  • Configurer la mise à l'échelle automatique : Cluster Autoscaler, Vertical Pod Autoscaler, Horizontal Pod Autoscaler
  • Mettre en place des budgets et des alertes de coûts
  • Définir la stratégie de mise à niveau

Autopilot vs Standard

Autopilot

  • Gestion entièrement gérée du plan de contrôle et des nœuds
  • Optimisation automatique des ressources
  • Modèle de facturation basé sur les ressources consommées (CPU, mémoire, éphémère)
  • Idéal pour les charges de travail conteneurisées standard

Standard

  • Contrôle total sur la configuration des nœuds (images, disques, métriques)
  • Possibilité d'utiliser des pools de nœuds personnalisés
  • Facturation basée sur les nœuds (vCPU, mémoire) plus les frais de gestion du plan de contrôle
  • Adapté aux charges de travail nécessitant un matériel spécifique (GPU, TPU, nœuds à haute mémoire)

Configuration réseau

Cluster privé

# Exemple de configuration pour un cluster privé
privateClusterConfig:
  enablePrivateNodes: true
  enablePrivateEndpoint: false
  masterIpv4CidrBlock: "10.0.0.0/28"

VPC natif (alias IP)

gcloud container clusters create CLUSTER_NAME \
    --network NETWORK_NAME \
    --subnetwork SUBNET_NAME \
    --enable-ip-alias \
    --cluster-secondary-range-name POD_RANGE \
    --services-secondary-range-name SERVICE_RANGE

API Gateway

Activer l'API Gateway pour la gestion du trafic entrant et sortant :

gcloud services enable gateway.googleapis.com
gcloud container clusters update CLUSTER_NAME \
    --gateway-api=standard

Sécurité

Workload Identity

Permet aux conteneurs d'utiliser des comptes de service GCP sans secrets :

gcloud container clusters create CLUSTER_NAME \
    --workload-pool=PROJECT_ID.svc.id.goog

Gestion des secrets avec Secret Manager

# Exemple de déploiement avec montage de secrets
apiVersion: v1
kind: Pod
metadata:
  name: my-app
spec:
  containers:
  - name: my-app
    image: gcr.io/my-project/my-app
    env:
    - name: DB_PASSWORD
      valueFrom:
        secretKeyRef:
          name: my-secret
          key: password

Renforcement RBAC

# Exemple de rôle RBAC minimaliste
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  namespace: default
  name: pod-reader
rules:
- apiGroups: [""]
  resources: ["pods"]
  verbs: ["get", "watch", "list"]

Observabilité

  • Activer Cloud Monitoring pour la collecte des métriques
  • Configurer Cloud Logging pour les journaux d'audit et d'application
  • Utiliser Managed Service pour Prometheus pour les métriques personnalisées
  • Configurer les alertes : Seuils de CPU/mémoire, déploiements échoués, nœuds indisponibles

Mise à l'échelle

Cluster Autoscaler

gcloud container clusters update CLUSTER_NAME \
    --enable-autoscaling \
    --min-nodes 3 \
    --max-nodes 10

Vertical Pod Autoscaler

# Exemple de VPA en mode recommend
apiVersion: autoscaling.k8s.io/v1
kind: VerticalPodAutoscaler
metadata:
  name: my-app-vpa
spec:
  targetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: my-app
  updatePolicy:
    updateMode: "Auto"

Horizontal Pod Autoscaler

# Exemple de HPA basé sur l'utilisation CPU
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: my-app-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: my-app
  minReplicas: 2
  maxReplicas: 10
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 70

Optimisation des coûts

  • Utiliser des réservations de capacité (committed use discounts) pour les charges de travail prévisibles
  • Configurer des budgets et des alertes dans Cloud Billing
  • Activer l'arrêt automatique des nœuds inactifs avec Cluster Autoscaler
  • Utiliser des classes de calcul pour les charges de travail à courte durée de vie
  • Éviter le gaspillage de ressources en utilisant des limites de conteneurs précises

Inférence IA/ML

Pour les charges de travail d'inférence IA/ML sur GKE :

  • Utiliser des nœuds GPU (A100, T4, etc.) avec des drivers NVIDIA
  • Déployer des modèles avec Triton Inference Server ou TensorFlow Serving
  • Activer le scaling automatique basé sur la latence et le débit
  • Utiliser des services de cache pour les modèles fréquemment utilisés
  • Configurer des stratégies de mise en cache des résultats

Ressources supplémentaires


Ce skill est maintenu par la communauté. Pour les problèmes ou les suggestions, veuillez ouvrir un ticket dans le référentiel GitHub.

Individual skills in this repo

This repo contains 18 individual skills — each has its own dedicated page.

google/agent-platform-skill-registry

Interact with the Gemini Enterprise Agent Platform Skill Registry to create and search for available skills. Use this skill to enable agents to register functionality or discover new capabilities.

google/alloydb-basics

Manages clusters, instances, and backups for AlloyDB for PostgreSQL, and integrates with AlloyDB model context protocol (MCP) tools for automated database operations.

google/bigquery-basics

Manages datasets, tables, and jobs in BigQuery, and integrates with BigQuery ML and Gemini for advanced data analytics and AI-driven insights. Use when you need to interact with BigQuery, run SQL queries, manage BigQuery resources, or leverage BigQuery's built-in ML capabilities. Also use when performing data analysis, ingesting data into BigQuery, or developing AI applications on BigQuery.

google/cloud-run-basics

Manages Cloud Run services, jobs, and worker pools. Use when you need to deploy applications responding to HTTP requests (services), run event-triggered or scheduled tasks (jobs), or handle always-on pull-based background processing (worker pools).

google/cloud-sql-basics

This file generates or explains Cloud SQL resources. Use this file when the user asks to create a Cloud SQL instance or database for MySQL, PostgreSQL, or SQL Server. Cloud SQL manages third-party MySQL, PostgreSQL, and SQL Server instances as resources in Cloud SQL. For example, when Cloud SQL creates an open-source MySQL instance, the resulting resource is a Cloud SQL for MySQL instance that Google Cloud manages. Cloud SQL handles backups, high availability, and secure connectivity for relational database workloads.

google/firebase-basics

Use this skill whenever you are working on a project that uses Firebase products or services, especially for mobile or web apps.

google/gemini-api

Use when the user asks about using Gemini in an enterprise environment or explicitly mentions Vertex AI, Google Cloud, or Agent Platform. Guides the usage of the Gemini API on Agent Platform with the Google Gen AI SDK. Covers SDK usage (Python, JS/TS, Go, Java, C#), capabilities like multimodal inputs, tools, media generation, caching, batch prediction, and Live API.

google/gemini-interactions-api

Guides the usage of Gemini Interactions API on Gemini Enterprise Agent Platform. Use when the user wants to use the stateful, server-managed Interactions API for multi-turn conversations, background execution, streaming, structured output, and function calling on the Agent Platform.

google/google-cloud-networking-observability

Investigates Google Cloud networking issues by analyzing logs, metrics, and diagnostics. Use when investigating VPC Flow Logs (including cost estimation), NAT, firewall, or threat logs, querying latency and throughput metrics, or running Connectivity Tests for path diagnostics. Don't use for generic VM management or non-observability tasks.

google/google-cloud-recipe-auth

Provides expert guidance on authenticating and authorizing to Google Cloud services and APIs, covering human users, service identities, Application Default Credentials (ADC), and best practices for secure access.

google/google-cloud-recipe-networking-observability

Investigates Google Cloud networking issues by analyzing logs, metrics, and diagnostics. Use when investigating VPC Flow Logs, NAT, firewall, or threat logs, querying latency and throughput metrics, or running Connectivity Tests for path diagnostics.

google/google-cloud-recipe-onboarding

Guides a developer's first steps on Google Cloud, covering account creation, billing setup, project management, and deploying a first resource. Use when a new developer wants to initialize their first Google Cloud project, configure billing, and verify deployment. Don't use for enterprise organization setup (use Google Cloud Setup guided flow for that instead). Don't use for complex multi-project architectures.

google/google-cloud-waf-cost-optimization

Generates cost optimization guidance for Google Cloud workloads based on the Google Cloud Well-Architected Framework (WAF). Use this skill to evaluate a workload, identify cost requirements and constraints, and provide actionable recommendations for build, deploy, and manage the workload cost-efficiently in Google Cloud.

google/google-cloud-waf-operational-excellence

Generates operations-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Operational Excellence pillar of the Google Cloud Well-Architected Framework (WAF). Use this skill to evaluate a workload, identify operational requirements, and provide actionable recommendations for deployment, monitoring, and incident management.

google/google-cloud-waf-performance-optimization

Generates performance-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Performance Optimization pillar of the Google Cloud Well-Architected Framework (WAF). Use this skill to evaluate a workload, identify performance requirements, and provide actionable recommendations for resource allocation, modular design, and elasticity.

google/google-cloud-waf-reliability

Generates reliability-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Google Cloud Well-Architected Framework. Use this skill to evaluate a workload, identify reliability requirements, and provide actionable recommendations for build, deploy, and manage the workload reliably in Google Cloud.

google/google-cloud-waf-security

Generates security-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Google Cloud Well-Architected Framework (WAF). Use this skill to evaluate a workload, identify security requirements, and provide actionable recommendations for IAM, network security, data protection, and operational security.

google/google-cloud-waf-sustainability

Generates sustainability-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Google Cloud Well-Architected Framework (WAF). Use this skill to evaluate a workload, identify environmental impact requirements, and provide actionable recommendations to build, deploy, and manage the workload sustainably in Google Cloud.

Skills associés