Installer gcloud CLI

Cette page contient des instructions sur le choix et la maintenance d'une installation de Google Cloud CLI. Google Cloud CLI inclut les outils de ligne de commande gcloud, gsutil et bq. Pour obtenir la liste des fonctionnalités de gcloud CLI, consultez 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.

Avant de suivre les instructions de ce guide, lisez Configurer la Google Cloud CLI pour Trusted 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 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.9 à 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 149,7 Mo 1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f
    Linux 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 56,3 Mo e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9
    Linux 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 56,3 Mo 09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07

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

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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. (Facultatif) Ajoutez gcloud CLI à votre PATH. Vous pouvez également activer l'achèvement de commande pour votre shell et la collecte des statistiques d'utilisation. Exécutez le script d'installation (à 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) 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
    • 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. Si vous avez mis à jour votre PATH à l'étape précédente, 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.
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.9 à 3.13.
    • Le script d'installation principal propose d'installer Python 3.12 pour CPython.
      • Les outils de ligne de commande Xcode sont nécessaires pour installer Python.
      • Vérifiez que les outils de ligne de commande Xcode sont installés en exécutant la commande xcode-select -p.
      • Si les outils de ligne de commande Xcode ne sont pas installés, installez-les en exécutant la commande sudo xcode-select --install.
    • 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 56,4 Mo 0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822
    macOS 64 bits

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 56,4 Mo 80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70
    macOS 32 bits

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 54,9 Mo 53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a
  3. 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. Vous pouvez également exécuter la commande suivante : 
    tar -xf google-cloud-cli-darwin-arm.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. Exécutez le script d'installation (à 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

    Le script vous invite à installer Python 3.12 et certains modules recommandés.

    L'installation 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, procédez comme suit : 
    ./google-cloud-sdk/install.sh --screen-reader=true
     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. Si vous avez mis à jour votre PATH à l'étape précédente, 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. 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://storage.s3nsapis.fr/cloud-sdk-release/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.9 à 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 la gcloud CLI avec des scripts ou dans le cadre d'une intégration continue/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 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.

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 qui figurent 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.9 à 3.13. Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la page gcloud topic startup.