MemoriaGCP

tekio.org

gcloud CLI

Poste du développeur ou machine CIProjet GCPConfiguration activeprojet, région, comptegcloud CLIgcloud, bq, gcloud storageIdentifiantsADC, clé, jeton d'accèsAPIs Google Cloudpoints d'entrée RESTIAMrôles et permissionsRessourcesVM, buckets12345
  1. La configuration active fournit le projet, la région et le compte : les commandes n'ont plus à les répéter, et gcloud config configurations activate fait basculer d'un contexte à l'autre.
  2. gcloud auth login stocke les identifiants de l'utilisateur ; gcloud auth application-default login écrit le fichier ADC que liront les bibliothèques clientes du même poste.
  3. Chaque commande est un appel REST signé par un jeton OAuth dérivé de ces identifiants.
  4. IAM vérifie que le principal appelant porte le rôle exigé par la méthode ; sinon l'appel repart en erreur 403.
  5. L'API crée, lit, modifie ou supprime la ressource visée dans le projet.

Ce que c'est

L'outil en ligne de commande de Google Cloud. La documentation distingue deux niveaux : Cloud SDK désigne l'ensemble des outils de développement — la CLI, les bibliothèques clientes et les extensions d'IDE ; Google Cloud CLI, couramment appelée gcloud CLI, est le paquet installable qui contient les commandes.

  • Outils du paquet : gcloud (toute la plateforme), bq (BigQuery) et gsutil déconseillé (Cloud Storage, outil hérité que remplacent les commandes gcloud storage). kubectl et divers émulateurs s'installent en composants supplémentaires.
  • Composants. L'installation est modulaire : gcloud components list, install, update, remove. Les composants gcloud, bq, gsutil et core sont installés par défaut ; alpha, beta et preview ne le sont pas et sont proposés à l'installation à la première commande qui en a besoin. Le gestionnaire de composants est désactivé quand la CLI vient d'un gestionnaire de paquets système (apt, yum) : la mise à jour passe alors par ce gestionnaire.
  • Niveaux de publication : GA (stable, sans étiquette), preview, beta, alpha. Les commandes sont organisées en groupes imbriqués — gcloud compute instances list, gcloud beta compute.
  • Configurations. Une configuration est un jeu nommé de propriétés (projet, région, zone, compte actif, verbosité, invites). Les fichiers vivent dans ~/.config/gcloud (ou %APPDATA%\gcloud, ou le chemin de CLOUDSDK_CONFIG). Plusieurs configurations cohabitent, activées par gcloud config configurations activate ou choisies à la commande par --configuration. Voir Configurations gcloud.
  • Authentification. gcloud init enchaîne connexion et configuration. Ensuite : identifiants stockés (gcloud auth login), fichier d'identifiants (fédération d'identité de charge de travail ou clé de compte de service), ou jeton d'accès fourni directement pour les environnements sans stockage. gcloud auth application-default login écrit les Application Default Credentials que lisent les bibliothèques clientes — deux mécanismes distincts, à ne pas confondre (voir Authentifier un appel). Sur une VM Compute Engine, dans Cloud Run ou dans Cloud Build, le serveur de métadonnées fournit les identifiants sans configuration ; dans Cloud Shell, c'est le compte de la console.
  • Sortie et scripts : --format (json, yaml, csv, value), --filter, projections ; gcloud topic formats, filters et projections documentent la syntaxe. Un serveur MCP distant préversion expose gcloud et bq à une application d'IA.
  • Facturation : l'outil est gratuit ; seules les ressources qu'il crée sont facturées.

gsutil est un outil hérité, peu maintenu, qui ignore les fonctions récentes de Cloud Storage (suppression réversible, dossiers gérés). Les commandes gcloud storage le remplacent et atteignent de meilleurs débits sans réglage manuel. Après mars 2027, gsutil ne sera plus livré avec la gcloud CLI et ne s'installera plus que séparément, depuis PyPI.

À quoi ça sert

  • Créer, inspecter et supprimer les ressources d'un projet sans passer par la console : c'est l'interface de référence, celle que la documentation donne en exemple.
  • Scripter des tâches répétitives — création d'environnements, ménage, extraction d'inventaire — en combinant --format et --filter avec jq ou un shell.
  • Authentifier un poste de développement : gcloud auth application-default login suffit à ce que le code local appelle les APIs avec le compte du développeur.
  • Ouvrir un accès à une machine ou à un service : gcloud compute ssh, gcloud workstations start-tcp-tunnel, gcloud container clusters get-credentials.
  • Copier des données : gcloud storage cp et gcloud storage rsync vers et depuis Cloud Storage, bq load et bq query pour BigQuery.

À éviter pour décrire une infrastructure durable : une suite de commandes impératives ne se rejoue pas et ne se compare pas à l'état réel ; c'est le domaine de l'infrastructure as code. À éviter aussi comme client applicatif : un programme doit appeler les bibliothèques clientes ou l'API REST, pas lancer des sous-processus gcloud, dont la sortie n'est pas un contrat stable. Pour une commande ponctuelle sans rien installer, Cloud Shell a déjà la CLI à jour et authentifiée.

Alternatives en logiciel libre

La gcloud CLI n'a pas d'équivalent libre : elle parle à des APIs propriétaires. Les projets ci-dessous remplacent tel ou tel de ses usages.

  • OpenTofu : gestion déclarative des ressources Google Cloud, sous licence MPL 2.0 — le pendant libre de Terraform, dont la licence (BSL) n'est pas libre. Remplace les commandes impératives de création.
  • Pulumi : même rôle, l'infrastructure étant décrite dans un langage de programmation.
  • Crossplane : provisionnement des ressources cloud depuis Kubernetes, par des manifestes réconciliés en continu.
  • Apache Libcloud : bibliothèque Python unifiée sur plusieurs fournisseurs, pour scripter calcul et stockage sans dépendre des clients Google.
  • rclone : copie et synchronisation vers Cloud Storage, à la place de gcloud storage et de gsutil ; s5cmd pour les transferts massifs via l'interface compatible S3.
  • k9s et kubectl : pilotage d'un cluster GKE une fois les identifiants récupérés.

Documentation