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 593.0.0

Linux
  1. Vérifiez que vous disposez d'une version compatible de Python. La Google Cloud CLI nécessite Python 3.10 à 3.15. Les packages Linux x86_64 et Arm incluent 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 94,7 Mo 181a74765ab1f2d3dd37bc1b7f9b53b6f5b348eef44ea2e194b9ed41310b44bb
    Linux 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 90,7 Mo 13e40f07f44bb6380a8d17275e352964360543af8ea18a7ddfee0445481f9413
    Linux 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 54,8 Mo 476eef9d8f890795c246b6c567e7623e3c404c0c824d2e3be6f6be81d08bfe74

    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 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.
macOS
  1. Vérifiez que vous disposez d'une version compatible de Python. La 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 installera Python v3.14 et les modules d'extension requis par défaut.

    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 :
    Plate-forme Package Taille Somme de contrôle SHA256
    macOS 64 bits

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 54,9 Mo 108c1a0bb5d273703b61c4dc9cafab9cc0e674797347ab18d5357d228a517131
    macOS 64 bits

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 54,8 Mo 563b2102362a54506836b73ef3485b6abfe112c1e48559022bbb5dbf45f55e4e
    macOS 32 bits

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 53,2 Mo 35d83632d1b2fc48fe342c957a3105995d5f855c2d770b37de277178f0cfe2d8

    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 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 la 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://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 d'indicateurs 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.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 Google Cloud CLI. Décochez l'option permettant de démarrer le shell. Vous allez exécuter et configurer 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.

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 à 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 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 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 à 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
*                  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

    La 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

    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 gcloud CLI au niveau de la version alpha ou bêta, consultez Gérer les composants de gcloud CLI.

Étapes suivantes

  • Consultez le guide de gcloud CLI pour obtenir une présentation de 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 Cloud de Confiance.
  • Consultez l'aide-mémoire de la gcloud CLI pour obtenir la liste des commandes couramment utilisées et des concepts clés.