gcloud CLI
- 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.
- 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.
- Chaque commande est un appel REST signé par un jeton OAuth dérivé de ces identifiants.
- IAM vérifie que le principal appelant porte le rôle exigé par la méthode ; sinon l'appel repart en erreur 403.
- 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) etgsutildéconseillé (Cloud Storage, outil hérité que remplacent les commandesgcloud storage).kubectlet divers émulateurs s'installent en composants supplémentaires. - Composants. L'installation est modulaire :
gcloud components list,install,update,remove. Les composantsgcloud,bq,gsutiletcoresont installés par défaut ;alpha,betaetpreviewne 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 deCLOUDSDK_CONFIG). Plusieurs configurations cohabitent, activées pargcloud config configurations activateou choisies à la commande par--configuration. Voir Configurations gcloud. - Authentification.
gcloud initenchaî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,filtersetprojectionsdocumentent la syntaxe. Un serveur MCP distant préversion exposegcloudetbqà une application d'IA. - Facturation : l'outil est gratuit ; seules les ressources qu'il crée sont facturées.
gsutilest un outil hérité, peu maintenu, qui ignore les fonctions récentes de Cloud Storage (suppression réversible, dossiers gérés). Les commandesgcloud storagele remplacent et atteignent de meilleurs débits sans réglage manuel. Après mars 2027,gsutilne 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
--formatet--filteravecjqou un shell. - Authentifier un poste de développement :
gcloud auth application-default loginsuffit à 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 cpetgcloud storage rsyncvers et depuis Cloud Storage,bq loadetbq querypour 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 storageet degsutil; 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.