Il est possible que certaines ou toutes les informations de cette page ne s'appliquent pas au cloud de confiance par S3NS.

Cette page a été traduite par l'API Cloud Translation.

Installer Google Cloud CLI

Ce guide de démarrage rapide vous aide à installer et à initialiser Google Cloud CLI, ainsi qu'à exécuter quelques commandes gcloud CLI de base.

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

Avant de commencer

In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Make sure that billing is enabled for your Trusted Cloud 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 la dernière version de gcloud CLI (530.0.0)

Linux

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.

Téléchargez l'un des éléments suivants :

Remarque : Pour déterminer votre plate-forme Linux, exécutez uname -a sur la ligne de commande.

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.

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.
(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é.
Si vous avez mis à jour votre PATH à l'étape précédente, ouvrez un nouveau terminal pour que les modifications prennent effet.
Pour initialiser gcloud CLI, exécutez la commande gcloud init :

./google-cloud-sdk/bin/gcloud init

Installez des composants supplémentaires à l'aide du gestionnaire de composants.

macOS

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.
Téléchargez l'un des éléments suivants :
Remarque : Pour déterminer le nom de votre matériel, exécutez la commande uname -m depuis la ligne de commande.

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

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.
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é.
Si vous avez mis à jour votre PATH à l'étape précédente, ouvrez un nouveau terminal pour que les modifications prennent effet.
Pour initialiser gcloud CLI, exécutez la commande gcloud init :

./google-cloud-sdk/bin/gcloud init

Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.

Windows

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

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

Facultatif : installer les dernières bibliothèques clientes Google Cloud

Vous pouvez télécharger des bibliothèques clientes Cloud pour les langues disponibles.

Initialiser gcloud CLI

Utilisez la commande gcloud init pour effectuer plusieurs tâches de configuration courantes de la gcloud CLI. Il s'agit par exemple d'autoriser gcloud CLI à accéder à Trusted Cloud à l'aide des identifiants de votre compte utilisateur et de définir la configuration par défaut.

Initialisez la gcloud CLI :
```
gcloud init
```
Remarque : Pour empêcher la commande de lancer un navigateur Web, utilisez gcloud init --console-only. Pour procéder à l'autorisation sans navigateur Web et de manière non interactive, créez un compte de service avec les champs d'application appropriés à l'aide de la consoleTrusted Cloud et utilisez gcloud auth activate-service-account avec le fichier de clé JSON correspondant.
Acceptez l'option de connexion avec votre compte utilisateur Google :
```
To continue, you must log in. Would you like to log in (Y/n)? Y
```
Dans votre navigateur, connectez-vous à votre compte utilisateur Google lorsque vous y êtes invité, puis cliquez sur Autoriser pour autoriser l'accès aux ressources Trusted Cloud .
Dans l'invite de commande, sélectionnez un projet Trusted Cloud dans la liste des projets pour lesquels vous disposez du rôle Propriétaire, Éditeur ou Lecteur :
```
Pick cloud project to use:
 [1] [my-project-1]
 [2] [my-project-2]
 ...
 Please enter your numeric choice:
```
Si vous n'avez qu'un seul projet, gcloud init le sélectionne pour vous.

Si vous avez accès à plus de 200 projets, vous serez invité à saisir un ID de projet, à créer un projet ou à répertorier des projets.
```
This account has a lot of projects! Listing them all can take a while.
 [1] Enter a project ID
 [2] Create a new project
 [3] List projects
Please enter your numeric choice:
```
Remarque : Si vous choisissez de créer un projet, vous devez également activer la facturation sur votre projet pour utiliser les services Trusted Cloud by S3NS .

Si l'API Compute Engine est activée, gcloud init vous permet de choisir une zone Compute Engine par défaut :

Which compute zone would you like to use as project default?
 [1] [asia-east1-a]
 [2] [asia-east1-b]
 ...
 [14] Do not use default zone
 Please enter your numeric choice:

gcloud init confirme que vous avez terminé les étapes de configuration :

Run `gcloud help config` to learn how to change individual settings

This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects.
Run `gcloud topic configurations` to learn more.

Some things to try next:

* Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command.
* Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting
* Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.

(Facultatif) Pour améliorer l'expérience de lecture d'écran, activez la propriété accessibility/screen_reader :
```
gcloud config set accessibility/screen_reader true
```
Pour plus d'informations sur les fonctionnalités d'accessibilité disponibles avec gcloud CLI, 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 :

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
*                  example-user-1@gmail.com
                   example-user-2@gmail.com

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 = example-user-1@gmail.com
disable_usage_reporting = False
project = example-project

Affichez les informations relatives à l'installation de la gcloud CLI et à la configuration active :
```
gcloud info
```
La gcloud CLI affiche un résumé des informations concernant votre installation. Ce résumé comprend des informations relatives à votre système, aux composants du SDK installés, au compte utilisateur actif, au projet actuel et aux propriétés de la configuration active du SDK.
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.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Trusted Cloud , procédez comme suit :

Attention : La suppression d'un projet aura les effets suivants :

Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

In the Trusted Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

É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 Trusted Cloud.
Reportez-vous à l'aide-mémoire de la gcloud CLI pour obtenir la liste des commandes et concepts clés couramment utilisés.
Installez des composants supplémentaires, tels que les émulateurs App Engine ou kubectl, à l'aide du gestionnaire de composants de la gcloud CLI.