MemoriaGCP

tekio.org

gcloud : calcul et réseau

Les ressources zonales demandent --zone, les régionales --region ; gcloud config set compute/zone ZONE et compute/region REGION évitent de les répéter.

VM Compute Engine

Objectif Syntaxe Résultat
Créer une VM gcloud compute instances create VM --zone=ZONE --machine-type=e2-standard-4 --image-family=debian-12 --image-project=debian-cloud --subnet=SUBNET --no-address VM sans IP publique, sortie Internet par Cloud NAT ; --boot-disk-size=50GB pour agrandir le disque
VM avec son propre compte de service ... --service-account=SA@PROJECT_ID.iam.gserviceaccount.com --scopes=cloud-platform Droits fixés par les rôles IAM du compte ; scope cloud-platform pour ne pas limiter en plus par les scopes
VM Spot ... --provisioning-model=SPOT --instance-termination-action=STOP Prix réduit, arrêt possible à tout moment ; DELETE pour supprimer au lieu d'arrêter
VM à durée limitée ... --max-run-duration=4h --instance-termination-action=DELETE Arrêt ou suppression automatique après la durée, comptée depuis le dernier démarrage
Script de démarrage ... --metadata-from-file=startup-script=init.sh Exécuté en root à chaque démarrage
Étiquettes réseau et labels ... --tags=web,ssh-iap --labels=env=dev,equipe=data Tags : cibles des règles de pare-feu ; labels : tri et facturation
VM sécurisée au démarrage ... --shielded-secure-boot Démarrage sécurisé activé ; vTPM et contrôle d'intégrité le sont par défaut sur les images compatibles
Arrêter, démarrer gcloud compute instances stop VM --zone=ZONE / start VM arrêtée : plus de facturation du calcul, les disques restent facturés
Supprimer gcloud compute instances delete VM --zone=ZONE --keep-disks=boot Par défaut le disque de démarrage est supprimé avec la VM
Changer de type de machine gcloud compute instances set-machine-type VM --zone=ZONE --machine-type=e2-standard-8 VM arrêtée au préalable
Changer le compte de service gcloud compute instances set-service-account VM --zone=ZONE --service-account=SA@PROJECT_ID.iam.gserviceaccount.com --scopes=cloud-platform VM arrêtée au préalable
IP interne d'une VM gcloud compute instances describe VM --zone=ZONE --format="value(networkInterfaces[0].networkIP)" Adresse seule, pour un script
VM en cours d'exécution d'une région gcloud compute instances list --filter="status=RUNNING AND zone~europe-west1" Nom, zone, type, IP
SSH par IAP, sans IP publique gcloud compute ssh VM --zone=ZONE --tunnel-through-iap Tunnel par Identity-Aware Proxy ; exige roles/iap.tunnelResourceAccessor et une règle de pare-feu depuis 35.235.240.0/20 sur tcp:22
Commande à distance gcloud compute ssh VM --zone=ZONE --tunnel-through-iap --command="sudo journalctl -u app -n 50" Sortie de la commande, sans session interactive
Copier des fichiers gcloud compute scp fichier.txt VM:~/ --zone=ZONE --tunnel-through-iap --recurse pour un dossier
Ouvrir un port distant en local gcloud compute start-iap-tunnel VM 5432 --local-host-port=localhost:5432 --zone=ZONE Base de données ou console web de la VM accessibles sur le poste

Modèles d'instance et groupes gérés (MIG)

Objectif Syntaxe Résultat
Créer un modèle d'instance gcloud compute instance-templates create TPL-v1 --machine-type=e2-standard-2 --image-family=debian-12 --image-project=debian-cloud --region=REGION --subnet=SUBNET --no-address --metadata-from-file=startup-script=init.sh Mêmes options que instances create ; un modèle ne se modifie pas, on en crée un nouveau
Modèle régional ... --instance-template-region=REGION Modèle rattaché à une région plutôt que global
Créer un MIG régional gcloud compute instance-groups managed create MIG --template=TPL-v1 --size=3 --region=REGION VM réparties sur plusieurs zones de la région
Réparation automatique ... --health-check=HC --initial-delay=300 VM recréée si le contrôle d'état échoue, après le délai de démarrage
Mise à l'échelle automatique gcloud compute instance-groups managed set-autoscaling MIG --region=REGION --min-num-replicas=2 --max-num-replicas=10 --target-cpu-utilization=0.6 Ajoute ou retire des VM pour tenir 60 % de CPU en moyenne
Port nommé pour un load balancer gcloud compute instance-groups managed set-named-ports MIG --region=REGION --named-ports=http:8080 Le service de backend vise le nom http
Mise à jour progressive gcloud compute instance-groups managed rolling-action start-update MIG --region=REGION --version=template=TPL-v2 --max-surge=3 --max-unavailable=0 VM remplacées par lots, sans perte de capacité
Canary ... --version=template=TPL-v1 --canary-version=template=TPL-v2,target-size=10% 10 % des VM sur le nouveau modèle
Recréer toutes les VM gcloud compute instance-groups managed rolling-action replace MIG --region=REGION Même modèle, VM neuves
Redimensionner gcloud compute instance-groups managed resize MIG --region=REGION --size=5 Sans autoscaler actif
État des VM du groupe gcloud compute instance-groups managed list-instances MIG --region=REGION Statut, action en cours, version du modèle

Disques et instantanés

Objectif Syntaxe Résultat
Créer un disque gcloud compute disks create DISK --zone=ZONE --size=200GB --type=pd-balanced hyperdisk-balanced, pd-ssd... selon le type de machine
Disque régional gcloud compute disks create DISK --region=REGION --replica-zones=ZONE_A,ZONE_B --size=200GB --type=pd-balanced Réplication synchrone entre deux zones
Attacher un disque gcloud compute instances attach-disk VM --disk=DISK --zone=ZONE Disque visible dans la VM, à formater et monter
Agrandir un disque gcloud compute disks resize DISK --zone=ZONE --size=500GB À chaud ; étendre ensuite le système de fichiers ; réduire est impossible
Instantané ponctuel gcloud compute snapshots create SNAP --source-disk=DISK --source-disk-zone=ZONE Instantané incrémental, stocké en multirégion par défaut ; --storage-location=REGION pour le fixer
Planifier des instantanés gcloud compute resource-policies create snapshot-schedule SCHED --region=REGION --daily-schedule --start-time=02:00 --max-retention-days=14 puis gcloud compute disks add-resource-policies DISK --zone=ZONE --resource-policies=SCHED Instantané quotidien, conservé 14 jours ; heure en UTC
Restaurer un disque gcloud compute disks create DISK-2 --zone=ZONE --source-snapshot=SNAP Nouveau disque, dans n'importe quelle zone
Instantanés d'un disque gcloud compute snapshots list --filter="sourceDisk~DISK" --sort-by="~creationTimestamp" Du plus récent au plus ancien

Cloud Run

Objectif Syntaxe Résultat
Déployer une image gcloud run deploy SERVICE --image=REGION-docker.pkg.dev/PROJECT_ID/REPO/IMAGE:TAG --region=REGION --no-allow-unauthenticated --service-account=SA@PROJECT_ID.iam.gserviceaccount.com Nouvelle révision servie à 100 %, appel authentifié par IAM uniquement
Déployer depuis le code source gcloud run deploy SERVICE --source=. --region=REGION Construit par Cloud Build (Dockerfile ou buildpacks), image poussée dans Artifact Registry ; respecte .gcloudignore
Ressources et mise à l'échelle ... --cpu=2 --memory=1Gi --concurrency=80 --min-instances=1 --max-instances=20 --min-instances=1 évite le démarrage à froid, mais l'instance gardée prête est facturée même inactive
Variables et secrets ... --set-env-vars=ENV=prod --set-secrets=DB_PASSWORD=db-password:latest Secret Manager lu au démarrage de l'instance ; --update-env-vars pour modifier sans tout remplacer
Accès au VPC ... --network=NETWORK --subnet=SUBNET --vpc-egress=private-ranges-only Sortie VPC directe vers les IP privées ; all-traffic pour tout faire passer par le VPC
Limiter l'entrée ... --ingress=internal-and-cloud-load-balancing Refuse les appels directs depuis Internet ; internal pour le VPC seulement
Déployer sans basculer le trafic ... --no-traffic --tag=canary Révision testable sur l'URL https://canary---...run.app, sans trafic de production
Répartir le trafic gcloud run services update-traffic SERVICE --region=REGION --to-revisions=SERVICE-00012-abc=90,SERVICE-00013-def=10 Canary en pourcentages ; --to-latest pour tout rendre à la dernière révision
Donner le droit d'appeler gcloud run services add-iam-policy-binding SERVICE --region=REGION --member=serviceAccount:APPELANT@PROJECT_ID.iam.gserviceaccount.com --role=roles/run.invoker L'appelant présente un jeton d'identité dont l'audience est l'URL du service
Appeler un service privé depuis le poste gcloud run services proxy SERVICE --region=REGION --port=8080 http://localhost:8080 relaie avec les identifiants de l'utilisateur
URL et configuration gcloud run services describe SERVICE --region=REGION --format="value(status.url)" URL seule ; sans --format, révision active, image, compte de service
Révisions d'un service gcloud run revisions list --service=SERVICE --region=REGION Révisions, part de trafic, date
Lire les journaux gcloud run services logs read SERVICE --region=REGION --limit=50 Dernières entrées des 24 dernières heures par défaut (--freshness)
Créer un job gcloud run jobs create JOB --image=IMAGE --region=REGION --tasks=10 --parallelism=5 --max-retries=3 --task-timeout=30m --service-account=SA@PROJECT_ID.iam.gserviceaccount.com Tâches indexées par CLOUD_RUN_TASK_INDEX ; jobs deploy crée ou met à jour
Exécuter un job gcloud run jobs execute JOB --region=REGION --wait Attend la fin ; --update-env-vars ou --args pour surcharger cette exécution

GKE

Objectif Syntaxe Résultat
Créer un cluster Autopilot gcloud container clusters create-auto CLUSTER --region=REGION --network=NETWORK --subnetwork=SUBNET --cluster-secondary-range-name=pods --services-secondary-range-name=services --enable-private-nodes Nœuds gérés par Google, sans IP publique, plages secondaires du sous-réseau pour les pods et les services
Créer un cluster Standard gcloud container clusters create CLUSTER --region=REGION --num-nodes=1 --machine-type=e2-standard-4 --enable-autoscaling --min-nodes=1 --max-nodes=5 --workload-pool=PROJECT_ID.svc.id.goog En régional, --num-nodes s'entend par zone ; Workload Identity Federation for GKE activée
Ajouter un pool de nœuds Spot gcloud container node-pools create POOL --cluster=CLUSTER --region=REGION --spot --machine-type=e2-standard-4 Nœuds à prix réduit pour les charges tolérantes aux interruptions
Configurer kubectl gcloud container clusters get-credentials CLUSTER --region=REGION Contexte ajouté à ~/.kube/config ; exige le composant gke-gcloud-auth-plugin
Lister les clusters gcloud container clusters list Nom, emplacement, version, nombre de nœuds

Réseau VPC

Objectif Syntaxe Résultat
Créer un réseau en mode personnalisé gcloud compute networks create NETWORK --subnet-mode=custom Aucun sous-réseau créé d'office ; sans l'option, mode automatique avec un sous-réseau par région
Créer un sous-réseau gcloud compute networks subnets create SUBNET --network=NETWORK --region=REGION --range=10.10.0.0/20 --enable-private-ip-google-access Les VM sans IP publique atteignent les API Google
Sous-réseau avec plages secondaires ... --secondary-range=pods=10.20.0.0/16,services=10.30.0.0/20 Plages d'alias pour les pods et services GKE
Journaux de flux ... --enable-flow-logs Échantillon des connexions dans Cloud Logging
Agrandir un sous-réseau gcloud compute networks subnets expand-ip-range SUBNET --region=REGION --prefix-length=19 Extension sans coupure ; réduire est impossible
Sous-réseau proxy uniquement gcloud compute networks subnets create PROXY_SUBNET --network=NETWORK --region=REGION --range=10.129.0.0/23 --purpose=REGIONAL_MANAGED_PROXY --role=ACTIVE Requis par les load balancers Envoy régionaux
Réserver une IP externe statique gcloud compute addresses create IP_NAME --region=REGION --global pour un load balancer global
Réserver une IP interne gcloud compute addresses create IP_NAME --region=REGION --subnet=SUBNET --addresses=10.10.0.10 Adresse fixe dans le sous-réseau
Plage pour l'accès aux services privés gcloud compute addresses create RANGE --global --purpose=VPC_PEERING --prefix-length=16 --network=NETWORK Plage réservée aux services gérés (Cloud SQL en IP privée…)
Lire une IP réservée gcloud compute addresses describe IP_NAME --region=REGION --format="value(address)" Adresse seule

Pare-feu et Cloud NAT

Objectif Syntaxe Résultat
Autoriser SSH par IAP gcloud compute firewall-rules create allow-iap-ssh --network=NETWORK --direction=INGRESS --allow=tcp:22 --source-ranges=35.235.240.0/20 --target-tags=ssh-iap Seules les VM portant l'étiquette ssh-iap sont concernées
Autoriser les contrôles d'état gcloud compute firewall-rules create allow-hc --network=NETWORK --allow=tcp:8080 --source-ranges=35.191.0.0/16 --target-service-accounts=SA@PROJECT_ID.iam.gserviceaccount.com Cible par compte de service, plus sûre qu'une étiquette que tout éditeur de VM peut poser
Lister les règles d'un réseau gcloud compute firewall-rules list --filter="network~NETWORK" --sort-by=priority Priorité, direction, sources, cibles
Journaliser une règle gcloud compute firewall-rules update RULE --enable-logging Connexions autorisées ou refusées par la règle dans Cloud Logging
Créer une politique de pare-feu réseau gcloud compute network-firewall-policies create POLICY --global Ensemble de règles réutilisable, préféré aux règles VPC isolées
Ajouter une règle à la politique gcloud compute network-firewall-policies rules create 1000 --firewall-policy=POLICY --global-firewall-policy --direction=INGRESS --action=allow --layer4-configs=tcp:443 --src-ip-ranges=0.0.0.0/0 Le premier argument est la priorité
Associer la politique au réseau gcloud compute network-firewall-policies associations create --firewall-policy=POLICY --network=NETWORK --global-firewall-policy Règles appliquées à tout le réseau
Créer un Cloud Router gcloud compute routers create ROUTER --network=NETWORK --region=REGION Support de Cloud NAT ; plan de contrôle BGP pour VPN et Interconnect
Créer Cloud NAT gcloud compute routers nats create NAT --router=ROUTER --region=REGION --auto-allocate-nat-external-ips --nat-all-subnet-ip-ranges Sortie Internet pour toutes les VM et pods de la région sans IP publique
NAT avec IP fixes ... --nat-external-ip-pool=IP_1,IP_2 Adresses de sortie connues, à déclarer chez un partenaire
Diagnostiquer le NAT gcloud compute routers nats describe NAT --router=ROUTER --region=REGION Configuration, ports par VM, journalisation

Contexte : concevoir le réseau, choisir le calcul, Compute Engine, Cloud Run, GKE, VPC, filtres et formats.