Installer Google Cloud CLI

Installer Google Cloud CLI

Ce guide de démarrage rapide décrit la méthode recommandée pour installer et initialiser la Google Cloud CLI. Après l'initialisation, exécutez quelques commandes gcloud CLI de base pour afficher des informations sur votre installation et vérifier qu'elle a réussi.

Avant de commencer

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

Installer gcloud CLI version 590.0.0

Linux

1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.10 à 3.15. Le package Linux x86_64 inclut un interpréteur Python groupé qui sera privilégié par défaut. Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la documentation gcloud topic startup.
2. Téléchargez l'un des éléments suivants :
   Remarque : Pour déterminer votre plate-forme Linux, exécutez uname -a sur la ligne de commande.

   Plate-forme	Nom du package	Taille	Somme de contrôle SHA256
   Linux 64 bits (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	94,0 Mo	351ed4a2812c5525c1cee00334257a42c020fcaffa27d3067c1eec0a618dd83f
   Linux 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	54,4 Mo	dc3ad610faefe6f9d2e4472affe1db71836315f43ab3a3747221eb7595b431cb
   Linux 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	54,4 Mo	704d32be816d1aef1250721e52fc2d9e0802eab6eac513aef97db4c7ace19b2b

   Pour télécharger le fichier d'archive Linux, exécutez la commande suivante :

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

   Reportez-vous au tableau ci-dessus et remplacez google-cloud-cli-linux-x86_64.tar.gz par le nom du package *.tar.gz qui s'applique à votre configuration.

3. Pour extraire le contenu du fichier vers votre système de fichiers, exécutez la commande suivante :

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   Pour remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant, puis extrayez l'archive au même emplacement.
4. Exécutez le script d'installation à partir de la racine du dossier que vous avez extrait :

   ./google-cloud-sdk/install.sh

   Le script vous invite à effectuer les actions de configuration suivantes. Pour accepter, répondez Y lorsque vous y êtes invité.
   • Ajoutez gcloud CLI à votre PATH.
   • Activez la saisie semi-automatique des commandes.
   • Acceptez d'envoyer des statistiques d'utilisation anonymes pour nous aider à améliorer la gcloud CLI.
   Vous pouvez également effectuer l'installation de manière non interactive en fournissant des options. Pour afficher les options disponibles, exécutez la commande suivante :

   ./google-cloud-sdk/install.sh --help

5. Facultatif : Si vous avez mis à jour votre PATH à l'étape précédente, ouvrez un nouveau terminal pour que les modifications prennent effet.

Debian/Ubuntu

Contenu du package

La gcloud CLI est disponible sous forme de package pour l'installation sur des systèmes Debian et Ubuntu. Ce package ne contient que les outils de ligne de commande gcloud, gcloud alpha, gcloud beta, gsutil et bq. Il n'inclut pas kubectl, ni les extensions App Engine requises pour déployer une application à l'aide des commandes gcloud. Si vous voulez ces composants, vous devez les installer séparément.

Disponibilité des versions de package : les versions de package publiées au cours des 365 derniers jours sont conservées dans le dépôt.

Remarque : Pour des configurations spécifiques, d'autres méthodes d'installation sont disponibles :

• Si vous exécutez une version moderne d'Ubuntu avec le gestionnaire de packages Snap et que vous souhaitez bénéficier des mises à jour automatiques, vous pouvez installer la Google Cloud CLI en tant que package Snap.
• Si vous utilisez une instance Compute Engine, gcloud CLI est peut-être déjà installé. Pour obtenir la liste des images de système d'exploitation qui incluent la CLI par défaut, consultez Détails de l'OS.

Avant de commencer

Avant d'installer la gcloud CLI, assurez-vous que votre système d'exploitation remplit les conditions suivantes :

• Il s'agit d'une version d'Ubuntu qui n'est pas encore en fin de vie ou une version stable de Debian qui n'est pas encore en fin de vie.
• Les packages ont été mis à jour récemment. Pour ce faire, exécutez la commande suivante :

  sudo apt-get update

• ca-certificates, gnupg et curl sont installés. Pour installer ces packages, exécutez la commande suivante :

  sudo apt-get install ca-certificates gnupg curl

Installation

1. Importez la clé publique Google Cloud .

   • Pour les distributions plus récentes (Debian 9+ ou Ubuntu 18.04+), exécutez la commande suivante :

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • Pour les anciennes distributions, exécutez la commande suivante :

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   • Si la commande apt-key de votre distribution n'accepte pas l'argument --keyring, exécutez la commande suivante :

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   • Si vous ne pouvez pas obtenir les dernières mises à jour en raison de l'expiration d'une clé, procurez-vous le dernier fichier de clé apt-get.gpg.

2. Ajoutez l'URI de distribution de gcloud CLI en tant que source de package.
   • Pour les distributions plus récentes (Debian 9+ ou Ubuntu 18.04+), exécutez la commande suivante :

     echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   • Pour les distributions plus anciennes qui ne sont pas compatibles avec l'option de signature, exécutez la commande suivante :

     echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   Remarque : Vérifiez que vous n'avez pas d'entrées en double pour le dépôt cloud-sdk dans /etc/apt/sources.list.d/google-cloud-sdk.list.
3. Mettez à jour et installez gcloud CLI :

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Remarque : Si vous effectuez l'installation dans des machines virtuelles, des images de conteneurs ou des exécuteurs CI/CD automatisés dont les ressources sont limitées, vous pouvez exporter la variable d'environnement CLOUDSDK_SKIP_PY_COMPILATION=1 pendant l'installation pour ignorer la compilation Python côté hôte. Le temps d'installation du package passe ainsi de quelques minutes à quelques secondes :

   sudo CLOUDSDK_SKIP_PY_COMPILATION=1 apt-get install google-cloud-cli

   La définition de cette variable permet d'ignorer la compilation d'octets lors de l'installation, ce qui accélère la configuration du package au détriment d'une légère surcharge lors de l'exécution des commandes interactives.
   Pour plus d'options apt-get, telles que la désactivation des requêtes ou des simulations, consultez les pages man apt-get.

   Conseil Docker : Si vous installez gcloud CLI dans une image Docker, utilisez plutôt une étape RUN unique :

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   Pour les images de base plus anciennes non compatibles avec la commande gpg --dearmor :

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
         

4. (Facultatif) Installez l'un des composants supplémentaires suivants :
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-tools
   • google-cloud-cli-tests
   • kubectl

   Par exemple, vous pouvez installer le composant google-cloud-cli-app-engine-java comme suit :

   sudo apt-get install google-cloud-cli-app-engine-java

Revenir à une version antérieure de la gcloud CLI

Pour revenir à une version spécifique de gcloud CLI, où VERSION est au format 123.0.0, exécutez la commande suivante :

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Les versions de package publiées au cours des 365 derniers jours sont conservées dans le dépôt.

Red Hat/Fedora/CentOS

Contenu du package

La gcloud CLI est disponible sous forme de package pour l'installation sur les systèmes Red Hat Enterprise Linux 7, 8, 9 et 10, Fedora 41 et 42, et CentOS 7 et 8. Ce package ne contient que les commandes gcloud, gcloud alpha, gcloud beta, gsutil et bq. Il n'inclut pas kubectl ni les extensions App Engine requises pour le déploiement d'une application à l'aide des commandes gcloud, que vous pouvez installer séparément comme décrit plus loin dans cette section.

Disponibilité des versions de package : les versions de package publiées au cours des 365 derniers jours sont conservées dans le dépôt.

Remarque : Si vous utilisez une instance sur Compute Engine, Google Cloud CLI est installé par défaut sur un certain nombre d'images d'OS. Pour en obtenir la liste complète, consultez la page Détails des systèmes d'exploitation.

Installation

1. Mettez à jour DNF à l'aide des informations correspondant au dépôt gcloud CLI.

   • L'exemple de commande suivant concerne une installation compatible avec Red Hat Enterprise Linux 7, 8 ou 9. Veillez toutefois à mettre à jour les paramètres selon votre configuration :

     sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
     [google-cloud-cli]
     name=Google Cloud CLI
     baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
     EOM

   • Pour les installations compatibles avec RHEL 10, utilisez la commande suivante avec le gpgkey mis à jour :

     sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
     [google-cloud-cli]
     name=Google Cloud CLI
     baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
     EOM

   • Pour les installations ARM64 (aarch64), utilisez https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (compatible avec RHEL 7, 8 ou 9) ou https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (compatible avec RHEL 10) comme valeur baseurl.

2. Installez libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Installez gcloud CLI :

   sudo dnf install google-cloud-cli

   Remarque : Si vous effectuez l'installation dans des machines virtuelles, des images de conteneurs ou des exécuteurs CI/CD automatisés dont les ressources sont limitées, vous pouvez exporter la variable d'environnement CLOUDSDK_SKIP_PY_COMPILATION=1 pendant l'installation pour ignorer la compilation Python côté hôte. Le temps d'installation du package passe ainsi de quelques minutes à quelques secondes :

   sudo CLOUDSDK_SKIP_PY_COMPILATION=1 dnf install google-cloud-cli

   La définition de cette variable permet d'ignorer la compilation d'octets lors de l'installation, ce qui accélère la configuration du package au détriment d'une légère surcharge lors de l'exécution des commandes interactives.
   Remarque : Si vous n'avez pas effectué la migration vers dnf sur votre système, vous pouvez exécuter ces commandes à l'aide de yum.

   Vous pouvez également utiliser les options dnf/yum, telles que la désactivation des invites de commande ou des dry runs, avec les commandes fournies.

4. (Facultatif) Installez l'un des composants supplémentaires suivants :
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Par exemple, pour installer le composant google-cloud-cli-app-engine-java, exécutez la commande suivante :

   sudo dnf install google-cloud-cli-app-engine-java

Revenir à une version antérieure de la gcloud CLI

Pour revenir à une version spécifique de gcloud CLI, exécutez la commande suivante. Remplacez 123.0.0 par la version que vous souhaitez installer :

sudo dnf downgrade google-cloud-cli-123.0.0

Les versions de package publiées au cours des 365 derniers jours sont conservées dans le dépôt.

macOS

1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.10 à 3.15.

   Pour vérifier votre version de Python, exécutez python3 -V ou python -V.

   Le programme d'installation gcloud installe par défaut Python v3.14 et les modules d'extension requis.

   Pour en savoir plus sur la configuration de votre interpréteur Python, consultez la documentation de gcloud topic startup.

2. Téléchargez l'un des éléments suivants :
   Remarque : Pour déterminer votre plate-forme, exécutez la commande uname -m depuis la ligne de commande.

   Plate-forme	Package	Taille	Somme de contrôle SHA256
   macOS 64 bits (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	54,5 Mo	9ff4e7c7fa49eca2e61af3d6ba31735ed08f90e5fae503d19d4c1c520f818736
   macOS 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	54,4 Mo	b1f80ffe9cc970ff1935b4adfddd0fb89d7e7b3341a88d70216d4283211b8d2d
   macOS 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	52,9 Mo	b2da028700b7af4ebc2364fc59398921a3c2d67f91fe63d3a7a42648a54eb6ab

   Vous pouvez également télécharger l'archive à partir de la ligne de commande. Remplacez FILE_NAME par le nom du package de votre plate-forme dans le tableau ci-dessus.

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME

3. Extrayez le contenu du fichier vers l'emplacement de votre choix sur votre système de fichiers. Une pratique courante consiste à l'extraire dans votre répertoire d'accueil.

   Sur macOS, vous pouvez effectuer cette opération en ouvrant le fichier .tar.gz téléchargé à l'emplacement choisi. Vous pouvez également exécuter la commande suivante depuis la ligne de commande :

   tar -xf FILE_NAME

   Pour remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant, puis extrayez l'archive au même emplacement.

4. Exécutez le script d'installation à partir de la racine du dossier que vous avez extrait :

   ./google-cloud-sdk/install.sh

   Le script vous invite à effectuer les actions de configuration suivantes. Pour accepter, répondez Y lorsque vous y êtes invité.
   • Installez Python 3.14 et les modules recommandés si nécessaire.
   • Ajoutez gcloud CLI à votre PATH et activez l'achèvement de commande.
   • Acceptez d'envoyer des statistiques d'utilisation anonymes pour nous aider à améliorer la gcloud CLI.
   Vous pouvez également effectuer l'installation de manière non interactive en fournissant des options. Pour afficher les options disponibles, exécutez la commande suivante :

   ./google-cloud-sdk/install.sh --help

   Pour exécuter le script d'installation avec le mode lecteur d'écran activé :

   ./google-cloud-sdk/install.sh --screen-reader=true

5. Facultatif : Si vous avez mis à jour votre PATH à l'étape précédente, ouvrez un nouveau terminal pour que les modifications prennent effet.

Windows

La Google Cloud CLI sur Windows nécessite Windows 8.1 ou version ultérieure, ou Windows Server 2012 ou version ultérieure.

1. Téléchargez le programme d'installation de Google Cloud CLI.

   Sinon, vous pouvez ouvrir un terminal PowerShell et exécuter les commandes PowerShell suivantes.

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. Lancez le programme d'installation, puis suivez les instructions. Ce programme est signé par Google LLC.

   • Si vous utilisez un lecteur d'écran, cochez la case Activer le mode Lecteur d'écran. Cette option configure gcloud pour qu'il utilise des outils de suivi de l'état au lieu d'indicateurs de chargement Unicode, affiche la progression sous forme de pourcentage et aplatit les tables. Pour en savoir plus, consultez le guide des fonctionnalités d'accessibilité.
   • La Google Cloud CLI nécessite Python. Les versions compatibles sont Python 3.10 à 3.15. Par défaut, la version Windows de Google Cloud CLI est fournie avec Python 3. Pour utiliser Google Cloud CLI, votre système d'exploitation doit pouvoir exécuter une version compatible de Python.
   • Le programme d'installation installe toutes les dépendances nécessaires, y compris la version Python requise. Bien que Google Cloud CLI installe et gère Python 3 par défaut, vous pouvez si nécessaire utiliser une installation Python existante. Pour ce faire, décochez l'option "Installer la version incluse de Python". Pour savoir comment utiliser une installation Python existante, consultez la page gcloud topic startup.

3. Une fois l'installation terminée, le programme d'installation vous donne la possibilité de créer un menu Démarrer et des raccourcis sur le Bureau, et de démarrer le shell de la Google Cloud CLI. Décochez l'option permettant de démarrer le shell. Vous exécuterez et configurerez la gcloud CLI lors des prochaines étapes.

Conseils de dépannage

• Si l'installation échoue parce que la commande find n'est pas reconnue, assurez-vous que votre variable d'environnement PATH est définie de façon à inclure le dossier contenant find. Il s'agit généralement de C:\WINDOWS\system32;.
• Si vous avez désinstallé gcloud CLI, vous devez redémarrer votre système avant de l'installer à nouveau.
• Si la décompression échoue, exécutez le programme d'installation en tant qu'administrateur.

Chromebook

1. Configurez l'environnement de développement Linux sur votre Chromebook.
2. Ajoutez l'URI de distribution de gcloud CLI en tant que source de package. Exécutez la commande suivante :

   echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

3. Importez la clé publique Google Cloud :

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

4. Mettez à jour et installez gcloud CLI :

   sudo apt-get update && sudo apt-get install google-cloud-cli

5. (Facultatif) Installez l'un des composants supplémentaires suivants :
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Par exemple, pour installer le composant google-cloud-cli-app-engine-java, exécutez la commande suivante :

   sudo apt-get install google-cloud-cli-app-engine-java

Revenir à une version antérieure de gcloud CLI

Pour revenir à une version spécifique de gcloud CLI, exécutez la commande suivante. Remplacez 123.0.0 par la version que vous souhaitez installer :

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Les versions de package publiées au cours des 365 derniers jours sont conservées dans le dépôt.

Initialiser et autoriser la gcloud CLI

Si vous êtes derrière un proxy ou un pare-feu, consultez Configuration du proxy pour activer l'accès réseau pour la gcloud CLI.

Après avoir installé la gcloud CLI, initialisez-la pour autoriser l'accès à Google Cloud et configurer une configuration par défaut. Pour en savoir plus, consultez la section gcloud init.

1. Exécutez gcloud init pour initialiser la gcloud CLI :

   gcloud init
   

   Par défaut, cette commande ouvre un navigateur Web pour autoriser l'accès. Pour autoriser l'accès à partir de la ligne de commande, ajoutez l'option --console-only. Pour une autorisation non interactive, créez un compte de service avec les champs d'application appropriés dans la consoleGoogle Cloud , puis utilisez gcloud auth activate-service-account avec son fichier de clé JSON.

2. Suivez les instructions pour autoriser et configurer :

   • Lorsque vous êtes invité à vous connecter, acceptez, puis connectez-vous à votre compte Google dans votre navigateur. Cliquez sur Autoriser pour accorder l'autorisation d'accéder aux ressources.

   • Dans la liste des projets pour lesquels vous disposez des autorisations Propriétaire, Éditeur ou Lecteur, sélectionnez un projet. Si vous n'avez qu'un seul projet, gcloud init le sélectionne pour vous.

     Si vous avez plus de 200 projets, vous êtes invité à saisir un ID de projet, à créer un projet ou à lister les projets. Si vous choisissez de créer un projet, vous devez également activer la facturation pour celui-ci.

   • Si l'API Compute Engine est activée, sélectionnez une zone Compute Engine par défaut.

3. Facultatif : Pour améliorer l'expérience du lecteur d'écran, activez la propriété accessibility/screen_reader à l'aide de la commande suivante :

   gcloud config set accessibility/screen_reader true
   

   Pour en savoir plus, consultez le guide Activer les fonctionnalités d'accessibilité.

Exécuter les commandes de base

Exécutez les commandes de base pour afficher des informations sur votre installation de la gcloud CLI :

1. Répertoriez les comptes dont les identifiants sont stockés sur le système local :

   gcloud auth list
   

   La gcloud CLI affiche une liste de comptes avec des identifiants :

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  [e-mail]
                      [e-mail]
   

2. Répertoriez les propriétés de votre configuration gcloud CLI active :

   gcloud config list
   

   La gcloud CLI affiche la liste des propriétés :

   [core]
   account = [e-mail]
   disable_usage_reporting = False
   project = example-project
   

3. Affichez des informations sur les commandes gcloud et d'autres sujets :

   gcloud help
   

   Par exemple, pour afficher l'aide de gcloud compute instances create :

   gcloud help compute instances create
   

   La gcloud CLI affiche une rubrique d'aide contenant une description de la commande, une liste des options et arguments de la commande, ainsi que des exemples d'utilisation de la commande.

Facultatif : Installer des composants supplémentaires

Pour installer des composants supplémentaires, tels que les émulateurs App Engine, kubectl ou les commandes de la gcloud CLI au niveau de la version alpha ou bêta, consultez Gérer les composants de la gcloud CLI.

Étapes suivantes

• Consultez le guide de la gcloud CLI pour obtenir une présentation de la gcloud CLI, y compris une brève introduction aux concepts clés, aux conventions de commande et à des conseils utiles.
• Consultez le guide de référence de la gcloud CLI pour obtenir des pages d'informations détaillées sur chaque commande de la gcloud CLI, y compris des descriptions, des options et des exemples, que vous pouvez utiliser pour effectuer diverses tâches sur Google Cloud.
• Consultez l'aide-mémoire de la gcloud CLI pour obtenir la liste des commandes couramment utilisées et des concepts clés.