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

Guide de démarrage rapide : premiers pas avec le SDK Cloud

Ce guide de démarrage rapide vous guide tout au long de l'installation et de l'initialisation du SDK Cloud, qui inclut l'outil de ligne de commande gcloud, ainsi que l'exécution de quelques commandes essentielles de l'outil gcloud pour vous aider à démarrer. Vous pouvez également utiliser le SDK Cloud sans installation à l'aide de Cloud Shell. Pour obtenir des conseils sur cette alternative, suivez le tutoriel interactif sur le SDK Cloud.

Installer la dernière version du SDK Cloud (361.0.0)

Linux

Le SDK Cloud nécessite Python. Les versions compatibles sont Python 3 (de préférence, 3.5 à 3.8) et Python 2 (2.7.9 ou version ultérieure).
```
python --version
```
Pour que le SDK Cloud s'exécute, votre système d'exploitation doit pouvoir exécuter l'une de ces versions Python compatibles. 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 version d'OS, exécutez getconf LONG_BIT dans votre ligne de commande.

Plate-forme	Package	Taille	Somme de contrôle SHA256
Linux 64 bits (x86_64)	google-cloud-sdk-361.0.0-linux-x86_64.tar.gz	92,2 Mo	4feba8ef2f0ae08427e326eb502dbf911a895e628b2b8c29e63c5c0408d96307
Linux 64 bits (arm)	google-cloud-sdk-361.0.0-linux-arm.tar.gz	89,6 Mo	74abf222ce333e6813643cbca9a6b1bad431a8b12290e5fc94f48331b4dce08e
Linux 32 bits (x86)	google-cloud-sdk-361.0.0-linux-x86.tar.gz	89,5 Mo	B7997C92107fd8b6aaf994593d6f80816ceb58d859ae0721c05085bf169eaa88

Sinon, pour télécharger le fichier d'archive Linux 64 bits à partir de votre ligne de commande, exécutez :

curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-361.0.0-linux-x86_64.tar.gz

Pour le fichier d'archive arm 64 bits, exécutez la commande suivante:

curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-361.0.0-linux-arm.tar.gz

Pour le fichier d'archive 32 bits, exécutez :

curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-361.0.0-linux-x86.tar.gz
Extrayez le contenu du fichier vers n'importe quel emplacement de votre système de fichiers (de préférence votre répertoire d'accueil). Si vous souhaitez remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant et extrayez l'archive au même emplacement.
Facultatif. Exécutez le script d'installation pour ajouter des outils du SDK Cloud à votre PATH. Vous pouvez également activer l'achèvement de commande pour votre interface système et la collecte des statistiques d'utilisation.
Exécutez le script (à 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) en fournissant des préférences sous forme d'options. Celles-ci sont décrites dans l'aide :
```
./google-cloud-sdk/install.sh --help
```
Ouvrez un nouveau terminal pour que les modifications prennent effet.
Exécutez gcloud init pour initialiser le SDK :

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

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

Debian/Ubuntu

Contenu du package

Le SDK Cloud est disponible sous forme de package pour l'installation sur des systèmes Debian et Ubuntu. Ce package ne contient que les commandes gcloud, gcloud alpha, gcloud beta, gsutil et bq. Il n'inclut pas kubectl, ni les extensions App Engine requises pour déployer une application à l'aide des commandes gcloud. Si vous voulez ces composants, vous devez les installer séparément, comme indiqué dans la suite de cette section.

Prérequis

Avant d'installer le SDK Cloud, assurez-vous d'utiliser l'un des systèmes d'exploitation suivants :

Version d'Ubuntu qui n'est pas encore en fin de vie
Version stable de Debian qui n'est pas encore en fin de vie

Installation

Ajoutez l'URI de distribution du SDK Cloud en tant que source de package :
```
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
```
Assurez-vous que apt-transport-https est installé :
```
sudo apt-get install apt-transport-https ca-certificates gnupg
```
Remarque : Si votre distribution n'accepte pas l'option de signature, exécutez plutôt la commande suivante :
```
echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
```
Remarque : Vérifiez que vous n'avez pas d'entrées en double pour le dépôt cloud-sdk dans /etc/apt/sources.list.d/google-cloud-sdk.list.
Importez la clé publique de Google Cloud :
```
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
```
Remarque : Si vous ne parvenez pas à obtenir les dernières mises à jour en raison d'une clé arrivée à expiration, procurez-vous le dernier fichier de clé apt-get.gpg.
Remarque : Si la commande apt-key de votre distribution n'accepte pas l'argument --keyring, exécutez cette commande à la place :
```
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
```

Mettez à jour le SDK Cloud, puis installez-le :

sudo apt-get update && sudo apt-get install google-cloud-sdk

Pour en savoir plus sur d'autres options apt-get, telles que la désactivation des invites ou des simulations, consultez les pages man apt-get.

Conseil Docker : Si vous installez le SDK Cloud dans une image Docker, utilisez plutôt une étape RUN unique.

RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y

(Facultatif) Installez l'un de ces composants supplémentaires :
- google-cloud-sdk-app-engine-python
- google-cloud-sdk-app-engine-python-extras
- google-cloud-sdk-app-engine-java
- google-cloud-sdk-app-engine-go
- google-cloud-sdk-bigtable-emulator
- google-cloud-sdk-cbt
- google-cloud-sdk-cloud-build-local
- google-cloud-sdk-datalab
- google-cloud-sdk-datastore-emulator
- google-cloud-sdk-firestore-emulator
- google-cloud-sdk-pubsub-emulator
- kubectl
Par exemple, vous pouvez installer le composant google-cloud-sdk-app-engine-java comme suit :
```
sudo apt-get install google-cloud-sdk-app-engine-java
```
Pour commencer, exécutez gcloud init :
```
gcloud init
```

Revenir à une version antérieure du SDK Cloud

Si vous souhaitez rétablir une version spécifique du SDK Cloud, avec VERSION au format 123.0.0, exécutez la commande suivante : sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0 Les 10 dernières versions seront toujours disponibles dans le dépôt.

Red Hat/Fedora/CentOS

Contenu du package

Le SDK Cloud est disponible sous forme de package pour l'installation sur les systèmes Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33, et CentOS 7 et 8. Ce package ne contient que les commandes gcloud, gcloud alpha, gcloud beta, gsutil et bq. Il n'inclut pas kubectl, ni les extensions App Engine requises pour le déploiement d'une application à l'aide des commandes gcloud, que vous pouvez installer séparément, comme décrit plus loin dans cette section.

Installation

Mettez à jour DNF à l'aide des informations de dépôt du SDK Cloud :
```
sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-sdk]
name=Google Cloud SDK
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el8-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
       https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
```
Important : La deuxième ligne de gpgkey doit être en retrait comme indiqué ici.

Remarque : L'extrait ci-dessus suppose une installation compatible avec Red Hat Enterprise Linux 8. Si vous utilisez une installation compatible avec Red Hat Enterprise Linux 7, vous devez remplacer "el8" par "el7" dans la valeur de "baseurl".
Installez le SDK Cloud :
```
sudo dnf install google-cloud-sdk
```

Remarque : Si vous n'avez pas effectué la migration vers dnf sur votre système, vous pouvez exécuter ces commandes à l'aide de yum. .

Vous pouvez également utiliser les options dnf/yum, telles que la désactivation des invites ou des simulations, avec les commandes fournies.

(Facultatif) Installez l'un de ces composants supplémentaires :
- google-cloud-sdk-app-engine-python
- google-cloud-sdk-app-engine-python-extras
- google-cloud-sdk-app-engine-java
- google-cloud-sdk-app-engine-go
- google-cloud-sdk-bigtable-emulator
- google-cloud-sdk-cbt
- google-cloud-sdk-cloud-build-local
- google-cloud-sdk-datalab
- google-cloud-sdk-datastore-emulator
- google-cloud-sdk-firestore-emulator
- google-cloud-sdk-pubsub-emulator
- kubectl
Par exemple, vous pouvez installer le composant google-cloud-sdk-app-engine-java comme suit :
```
sudo dnf install google-cloud-sdk-app-engine-java
```
Pour commencer, exécutez gcloud init :
```
gcloud init
```

Revenir à une version antérieure du SDK Cloud

Si vous souhaitez rétablir une version spécifique du SDK Cloud, avec VERSION au format 123.0.0, exécutez la commande suivante : sudo dnf downgrade google-cloud-sdk-VERSION Les 10 dernières versions seront toujours disponibles dans le dépôt.

macOS

Le SDK Cloud nécessite Python.
- Les versions compatibles sont Python 3 (version 3.7 recommandée) et Python 2 (version 2.7.9 ou ultérieure).
- Les versions modernes de macOS incluent la version de Python requise pour le SDK Google Cloud. Pour vérifier votre version actuelle de Python, exécutez python -V.
- Pour les versions 352.0.0 et ultérieures du SDK Cloud, le script d'installation principal propose d'installer Python 3.7 pour CPython sur les MAC basées sur Intel.
- 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-sdk-361.0.0-darwin-x86_64.tar.gz	92,7 Mo	AE86D17383db991bc32c1aae228ea5f08f8186086d95b84366b8f637730991bf
macOS 64 bits (arm64, Apple M1 silicon)	google-cloud-sdk-361.0.0-darwin-arm.tar.gz	92,6 Mo	9101f91dc8853424538547344e8fedb2a6d350d32b608de9399ca1d01b67825f
macOS 32 bits (x86)	google-cloud-sdk-361.0.0-darwin-x86.tar.gz	96,4 Mo	7ddb0eedab0d213f883a850ac6d838df3a02fdb155f71deeea452f06363af203.

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.
Si vous souhaitez remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant et extrayez l'archive au même emplacement.
Facultatif. Exécutez le script d'installation pour ajouter des outils du SDK Cloud à votre PATH.
Vous pouvez également activer l'achèvement de commande pour votre interface système et la collecte des statistiques d'utilisation, et éventuellement installer Python 3.7.
Exécutez le script (à 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) en fournissant des préférences sous forme d'options. Celles-ci sont décrites dans l'aide :
```
./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
```
Ouvrez un nouveau terminal pour que les modifications prennent effet.
Exécutez gcloud init pour initialiser le SDK :

./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 du SDK Cloud.

Sinon, vous pouvez ouvrir un terminal PowerShell et exécuter les commandes PowerShell suivantes.

(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/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é.
Le SDK Cloud nécessite Python. Les versions compatibles sont Python 3 (de préférence, 3.5 à 3.8) et Python 2 (2.7.9 ou version ultérieure). Le SDK Cloud est fourni avec Python 3 par défaut. Pour utiliser le SDK Cloud, 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 le SDK Cloud installe et gère Python 3 par défaut, vous pouvez utiliser une installation Python existante si nécessaire. Pour ce faire, décochez l'option "Install Bundled Python" (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 l'interface système du SDK Cloud et de configurer le SDK Cloud. Veillez à conserver les options pour démarrer l'interface système 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 du SDK Cloud.

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 venez de désinstaller le SDK Cloud, vous devez redémarrer votre système avant de l'installer à nouveau.

Facultatif: Installer les dernières bibliothèques clientes Cloud

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

Initialiser le SDK Cloud

Utilisez la commande gcloud init pour effectuer plusieurs tâches de configuration courantes du SDK Cloud. Il vous permet par exemple d'autoriser les outils du SDK Cloud à accéder à Google Cloud à l'aide des identifiants de votre compte utilisateur et de définir la configuration par défaut.

Pour initialiser le SDK Cloud, procédez comme suit :

Saisissez la commande suivante dans une invite :
```
```
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 Google Cloud Console 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 de Google Cloud.
Dans l'invite de commande, sélectionnez un projet Google Cloud dans la liste de ceux 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 devrez également activer la facturation sur votre projet pour pouvoir utiliser Google. Services cloud.

Si l'API Google 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 :

gcloud has now been configured!
You can use [gcloud config] to change more gcloud settings.

Your active configuration is: [default]

(Facultatif) Si vous souhaitez une expérience de lecture d'écran plus fluide, l'outil gcloud s'accompagne d'une propriété accessibility/screen_reader.

Pour activer cette propriété, exécutez la commande suivante :
```
gcloud config set accessibility/screen_reader true
```
Pour en savoir plus sur les fonctionnalités d'accessibilité fournies avec l'outil gcloud, consultez le guide Activer les fonctionnalités d'accessibilité.

Exécuter les commandes principales

Exécutez les commandes suivantes de l'outil gcloud pour afficher des informations sur votre installation du SDK Cloud:

Pour répertorier les comptes dont les identifiants sont stockés sur le système local :

```
gcloud auth list
```

L'outil gcloud affiche la liste des comptes avec identifiants:

       Credentialed Accounts
ACTIVE             ACCOUNT
*                  example-user-1@gmail.com
                   example-user-2@gmail.com

Pour répertorier les propriétés de la configuration active du SDK Cloud :

```
gcloud config list
```

L'outil gcloud affiche la liste des propriétés:

[core]
account = example-user-1@gmail.com
disable_usage_reporting = False
project = example-project

Pour afficher des informations sur votre installation du SDK Cloud et la configuration active :
```
```
gcloud info
```
```
L'outil gcloud affiche un résumé des informations sur votre installation du SDK Cloud. Cela inclut des informations sur votre système, les composants installés, le compte utilisateur actif et le projet en cours, ainsi que les propriétés de la configuration active.
Pour afficher des informations sur les commandes gcloud et d'autres sujets à partir de la ligne de commande, exécutez la commande suivante:
```
```
gcloud help
```
```
Par exemple, pour afficher l'aide de gcloud compute instances create :
```
```
gcloud help compute instances create
```
```
L'outil gcloud 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.

Étape suivante

Consultez le guide de l'outil gcloud pour obtenir une présentation de l'outil gcloud, y compris une présentation rapide des concepts clés et des conventions de commande, et des conseils utiles.
Consultez le guide de référence de l'outil gcloud pour obtenir des pages détaillées sur chaque commande de l'outil gcloud, y compris des descriptions, des indicateurs et des exemples que vous pouvez utiliser pour effectuer des opérations. diverses tâches sur Google Cloud.
Reportez-vous à l'aide-mémoire de l'outil gcloud pour obtenir la liste des commandes couramment utilisées et des concepts clés.
Installez des composants supplémentaires, tels que les émulateurs App Engine ou kubectl à l'aide du gestionnaire de composants du SDK Cloud.

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Essai gratuit