Installer gcloud CLI

Cette page contient des instructions sur le choix et la maintenance d'une installation de la Google Cloud CLI. La CLI Google Cloud inclut les outils de ligne de commande gcloud, gsutil et bq. Pour obtenir la liste des fonctionnalités de gcloud CLI, consultez la page Toutes les fonctionnalités.

Pour accéder aux API Google Cloud à l'aide d'un langage de programmation compatible, vous pouvez télécharger les bibliothèques clientes Cloud.

Instructions d'installation

Ces instructions concernent l'installation de Google Cloud CLI. Pour en savoir plus sur l'installation de composants supplémentaires, tels que les commandes de la gcloud CLI en version alpha ou bêta, consultez la section Gérer les composants de gcloud CLI.

Linux
  1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.8 à 3.13. Notez que 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 page gcloud topic startup.
  2. Téléchargez l'un des éléments suivants :
    Plate-forme Nom du package Taille Somme de contrôle SHA256
    Linux 64 bits

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 131,6 Mo beb7c8ef61c46ede9295bf68bfb331fbd158575cc3343db585d37b891c890336
    Linux 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 53,9 Mo 44eb95fd169f92c197f88df527c3aa27d5db9aa977c2fa2d28fa1cf506b00c9f
    Linux 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 53,9 Mo 10303f55226fac633761ae52e1dbcbcaf7c59fe11232f8196e6e361fc38e2e77

    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 (de préférence vers votre répertoire d'accueil), exécutez la commande suivante : 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Facultatif: Pour remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant, puis extrayez l'archive au même emplacement.
  4. Ajoutez gcloud CLI à votre PATH. Exécutez le script d'installation (à partir de la racine du dossier dans lequel vous l'avez extrait) à l'aide de la commande suivante : 
    ./google-cloud-sdk/install.sh
     Cette opération peut également être effectuée de manière non interactive (par exemple, à l'aide d'un script) et via des préférences sous forme d'options. Pour afficher les options disponibles, exécutez la commande suivante : 
    ./google-cloud-sdk/install.sh --help
     Facultatif :
    • Pour envoyer des statistiques d'utilisation anonymes afin de nous aider à améliorer gcloud CLI, répondez Y lorsque vous y êtes invité.
    • Pour ajouter gcloud CLI à votre PATH et activer l'achèvement de commande, répondez Y lorsque vous y êtes invité.
  5. Ouvrez un nouveau terminal pour que les modifications prennent effet.
  6. Pour initialiser gcloud CLI, exécutez la commande gcloud init : 
    7. ./google-cloud-sdk/bin/gcloud init
  7. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Debian/Ubuntu

Contenu du package

gcloud CLI est disponible sous forme de package pour l'installation sur des systèmes Debian et Ubuntu. 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 déployer une application à l'aide des commandes gcloud. Si vous voulez ces composants, vous devez les installer séparément.

Avant de commencer

Avant d'installer 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 : 
    sudo apt-get update
  • apt-transport-https et curl sont installés : 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl
Installation
  1. Importez la clé publique de 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
  3. Mettez à jour et installez gcloud CLI : 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Pour en savoir plus sur d'autres options apt-get, telles que la désactivation des invites 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 | sudo 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
    • 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-build-local
    • 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-kpt
    • 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, vous pouvez installer le composant google-cloud-cli-app-engine-java comme suit :

    sudo apt-get install google-cloud-cli-app-engine-java
  5. Pour commencer, exécutez gcloud init :
    gcloud init

Revenir à une version antérieure de 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 dix dernières versions sont toujours disponibles dans le dépôt.

REMARQUE : Pour les versions antérieures à 371.0.0, le nom du package est google-cloud-sdk.

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 et 9, Fedora 33 et 34, 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.

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 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
  2. Si vous effectuez l'installation sur Fedora 34 ou 35, installez libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Installez gcloud CLI : 
    sudo dnf install google-cloud-cli
  4. (Facultatif) Installez l'un des composants supplémentaires suivants :
    • google-cloud-cli
    • 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-build-local
    • 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-kpt
    • 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, vous pouvez installer le composant google-cloud-cli-app-engine-java comme suit :

    sudo dnf install google-cloud-cli-app-engine-java
  5. Pour commencer, exécutez gcloud init :
    gcloud init

Revenir à une version antérieure de gcloud CLI

Si vous souhaitez rétablir une version spécifique de gcloud CLI, où VERSION est au format 123.0.0, exécutez : sudo dnf downgrade google-cloud-cli-VERSION Les 10 dernières versions seront toujours disponibles dans le dépôt. REMARQUE : Pour les versions antérieures à 371.0.0, le nom du package est google-cloud-sdk.

macOS
  1. Vérifiez que vous disposez d'une version compatible de Python :
    • Pour vérifier votre version actuelle de Python, exécutez python3 -V OU python -V. Les versions compatibles sont Python 3.8 à 3.13.
    • Le script d'installation principal propose d'installer Python 3.11 pour CPython.
    • Sinon, pour installer une version compatible de Python, consultez la page Versions Python pour macOS du site Python.org.
    • Si plusieurs interpréteurs Python sont installés sur votre ordinateur, définissez la variable d'environnement CLOUDSDK_PYTHON dans votre interface système pour qu'elle pointe vers le chemin de l'interpréteur de votre choix.
    • Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la page gcloud topic startup.
  2. Téléchargez l'un des éléments suivants :

    3. Plate-forme Package Taille Somme de contrôle SHA256
    macOS 64 bits

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 53,9 Mo 9d1af0d2b5e7c8a30145831b99ce46272fc0aba754d7d23dcd3ede414b9ff75a
    macOS 64 bits

    (ARM64, Apple M1 silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 53,9 Mo d986d0c6531be038b71218f8e7e666c5b4d18ef580d6a063550406ed07e460f9
    macOS 32 bits

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 52,6 Mo e98b4bf6449b9207ff5c4bd3df12a1b38ffa0f498274b26f2d80cfe7fb124f81
    1. Extrayez l'archive dans n'importe quel emplacement de votre système de fichiers, de préférence votre répertoire d'accueil. Sur MacOS, vous pouvez effectuer cette opération en ouvrant le fichier d'archive .tar.gz téléchargé à l'emplacement choisi.

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

    2. (Facultatif) Exécutez le script d'installation pour ajouter les outils gcloud CLI à votre PATH. Vous pouvez également activer l'achèvement de commande pour votre shell, la collecte des statistiques d'utilisation, et installer Python 3.11.

      Exécutez le script (à partir de la racine du dossier que vous avez extrait à la dernière étape) à l'aide de la commande suivante :

      ./google-cloud-sdk/install.sh
       Cette opération peut également être effectuée de manière non interactive (par exemple, à l'aide d'un script) en fournissant des préférences sous forme d'options. Pour connaître les options disponibles, exécutez la commande suivante : 
      ./google-cloud-sdk/install.sh --help
       Pour exécuter le script d'installation en mode lecteur d'écran: 
      ./google-cloud-sdk/install.sh --screen-reader=true
       Ouvrez un nouveau terminal pour que les modifications prennent effet.
    3. Pour initialiser gcloud CLI, exécutez la commande gcloud init : 
      4. ./google-cloud-sdk/bin/gcloud init
    4. Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Windows
    Google Cloud CLI fonctionne sous Windows 8.1 et versions ultérieures, et Windows Server 2012 et versions ultérieures.

  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 utiliser des outils de suivi d'état au lieu des icônes de chargement Unicode, afficher la progression sous forme de pourcentage et aplatir les tables. Pour en savoir plus, consultez le guide des fonctionnalités d'accessibilité.

  3. Google Cloud CLI nécessite Python. Les versions compatibles sont Python 3.8 à 3.13. 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.

  4. 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, de démarrer le shell de Google Cloud CLI et de configurer gcloud CLI. Veillez à conserver les options pour démarrer le shell et configurer l'installation sélectionnée. Le programme d'installation affiche une fenêtre de terminal, puis exécute la commande gcloud init.

  5. L'installation par défaut n'inclut pas les extensions App Engine requises pour déployer une application à l'aide des commandes gcloud. Ces composants peuvent être installés à l'aide du gestionnaire de composants de gcloud CLI.
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.

Autres options d'installation

En fonction de vos besoins de développement, vous pouvez utiliser une autre méthode d'installation de la gcloud CLI que l'installation recommandée:

  • Vous utilisez gcloud CLI avec des scripts ou dans le cadre d'une intégration/d'un déploiement continu ? Téléchargez une archive avec versions gérées pour l'installation non interactive d'une version spécifique de gcloud CLI.
  • Vous souhaitez exécuter la gcloud CLI sous forme d'image Docker ? Utilisez l'image Docker de la CLI gcloud pour obtenir la dernière version (ou une version spécifique) de gcloud CLI.
  • Vous exécutez Ubuntu et préférez les mises à jour automatiques ? Installez la gcloud CLI à l'aide d'un package snap.
  • Pour les installations interactives sous Windows et macOS, et pour tous les autres cas d'utilisation, exécutez le programme d'installation interactif pour installer la dernière version de gcloud CLI.

Gérer une installation

Une fois que vous avez installé la gcloud CLI, vous pouvez utiliser les commandes du groupe de commandes gcloud components pour gérer votre installation. Vous pouvez entre autres afficher les composants installés, ajouter et supprimer des composants, et mettre à jour gcloud CLI ou revenir à une version antérieure spécifique.

Remarque: Si vous avez utilisé apt-get ou yum pour installer gcloud CLI, vous devez utiliser apt-get ou yum pour mettre à jour ou supprimer des composants, et non gcloud components.

Versions antérieures de gcloud CLI

Si vous avez besoin d'une autre version de gcloud CLI, installez la version actuelle en suivant les instructions figurant plus haut sur cette page, puis connectez-vous. Une fois connecté, vous pouvez télécharger les versions précédentes. Pour afficher les versions triées par date, assurez-vous d'activer Trier et filtrer, puis cliquez sur la colonne Créé.

Versions Python compatibles

Google Cloud CLI nécessite Python 3.8 à 3.13. Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la page gcloud topic startup.

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Essai gratuit