Installer Google Cloud CLI

Avant de suivre les instructions de ce guide, lisez Configurer la Google Cloud CLI pour Cloud de Confiance.

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 Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

Installer gcloud CLI version 561.0.0

Linux
  1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.10 à 3.14. 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 :
    Plate-forme Nom du package Taille Somme de contrôle SHA256
    Linux 64 bits

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 204,1 Mo abfde04edc59ab30289588094802e072e264c108e6bb2c6c863022d5eda37b13
    Linux 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 59,0 Mo 7a3732d7f80051cd5b362d32d0deafbf0b62a5cb62c145c89eebb21058dd6123
    Linux 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 59,0 Mo 63e6347e1d05d5b5586399af66e9db5e594b7ed1c433cfa418f168ab63e42e8d

    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, 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 dans lequel vous l'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.
macOS
  1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.10 à 3.14.

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

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

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

  2. Téléchargez l'un des éléments suivants :
    Plate-forme Package Taille Somme de contrôle SHA256
    macOS 64 bits

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 59,1 Mo 8bf5bf1e5e0947884b8eb5cebbbed49a34bac75550bfb4e2b511d7a25ea503de
    macOS 64 bits

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 59,0 Mo 8b0222f74b57fe9a6063cb8f460bf51db838d6166b2548ad4397bcafc8d472fd
    macOS 32 bits

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 57,5 Mo 4c023dc565c28d96527aed1f6a3c64cc6d679d54c6cd92d189a41c0fb2928d47

    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://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME
  3. Extrayez le contenu du fichier vers l'emplacement de votre choix dans votre système de fichiers. Une pratique courante consiste à l'extraire dans votre répertoire personnel.

    Sur macOS, vous pouvez effectuer cette opération en ouvrant le fichier .tar.gz téléchargé à l'emplacement de votre choix. Vous pouvez également exécuter la commande suivante à partir de 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 dans lequel vous l'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é.
    • Si nécessaire, installez Python 3.13 et les modules recommandés.
    • 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 en mode lecteur d'écran : 
    ./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

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://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é.
    • Google Cloud CLI nécessite Python. Les versions compatibles sont Python 3.10 à 3.14. 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 Google Cloud CLI. Décochez l'option permettant de démarrer le shell. Vous exécuterez et configurerez 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.

Initialiser et autoriser la gcloud CLI

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

Après avoir installé la gcloud CLI, initialisez-la pour autoriser l'accès à Cloud de Confiance 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 à partir de la ligne de commande, ajoutez l'indicateur --console-only. Pour l'autorisation non interactive, créez un compte de service avec les champs d'application appropriés dans la consoleCloud de Confiance , 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 à répertorier des projets. Si vous choisissez de créer un projet, vous devez également activer la facturation.

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

  3. Facultatif : Pour une meilleure expérience de lecture d'écran, activez la propriété accessibility/screen_reader avec 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 principales

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

    Gcloud CLI affiche la liste des comptes identifiés :

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com

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

    gcloud config list

    Gcloud CLI affiche la liste des propriétés :

    [core]
account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
disable_usage_reporting = False
project = my-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

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

Facultatif : Installer des composants supplémentaires

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

Étapes suivantes

  • Consultez le guide de la gcloud CLI pour obtenir une présentation de la gcloud CLI, avec une introduction rapide aux concepts clés et conventions de commande, ainsi que des conseils utiles.
  • Consultez le guide de référence de la gcloud CLI pour obtenir des informations détaillées sur chaque commande gcloud CLI. Vous y trouverez des descriptions, des options et des exemples qui vous permettront d'effectuer diverses tâches sur Cloud de Confiance.
  • Consultez l'aide-mémoire de la gcloud CLI pour obtenir la liste des commandes et concepts clés couramment utilisés.