Installer Google Cloud CLI

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.

Une fois que vous avez terminé les tâches décrites dans ce document, vous pouvez éviter de continuer à payer des frais en supprimant les ressources que vous avez créées. Pour en savoir plus, consultez la section Effectuer un nettoyage.

Installer gcloud CLI version 548.0.0

Linux

1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.9 à 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	202,9 Mo	71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a
   Linux 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	57,7 Mo	001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3
   Linux 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	57,8 Mo	921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc

   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 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.9 à 3.14.

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

   Le script d'installation peut installer Python pour vous si nécessaire. Cela nécessite les outils de ligne de commande Xcode. Pour les installer, exécutez sudo xcode-select --install. Vous pouvez également installer une version compatible de Python à partir de python.org.

   Pour en savoir plus sur la configuration de votre interpréteur Python, en particulier si vous avez installé plusieurs versions, 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	57,9 Mo	6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8
   macOS 64 bits (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,8 Mo	36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339
   macOS 32 bits (x86)	google-cloud-cli-darwin-x86.tar.gz	56,3 Mo	eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56

   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 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 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.9 à 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 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
   

   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.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Cloud de Confiance , procédez comme suit :

É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 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.