Ce guide de démarrage rapide vous aide à installer et à initialiser le SDK Cloud, ainsi qu'à exécuter quelques commandes gcloud
de base pour vous aider à démarrer.
Installer la dernière version du SDK Cloud (329.0.0)
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 plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la pagegcloud topic startup
.- Téléchargez l'un des éléments suivants :
-
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-329.0.0-linux-x86_64.tar.gz
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-329.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 :
- Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Plate-forme | Package | Taille | Somme de contrôle SHA256 |
---|---|---|---|
Linux 64 bits (x86_64) |
google-cloud-sdk-329.0.0-linux-x86_64.tar.gz | 113,3 Mo | bab65ba4976372a85bbf7f5d7c7cfceb851edd0fa00114151dea2492b8045854 |
Linux 32 bits (x86) |
google-cloud-sdk-329.0.0-linux-x86.tar.gz | 86,8 Mo | 141b394133104d149bf3ede72a35c050d6ef43af4f9ed055e5dbf2f3120941ee |
./google-cloud-sdk/bin/gcloud init
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.
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 à partir de Wheezy
- 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
- 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 -
- 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 optionsapt-get
, telles que la désactivation des invites ou des simulations, consultez les pages manapt-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.
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 32 et CentOS 7. 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.
- 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-el7-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM
- Installez le SDK Cloud :
sudo dnf install google-cloud-sdk
- (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.
- 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). Les versions modernes de macOS incluent la version de Python requise pour le SDK Google Cloud.
python -V
Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la pagegcloud topic startup
. - Téléchargez le fichier suivant :
- 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.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 :
- Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Plate-forme | Package | Taille | Somme de contrôle SHA256 |
---|---|---|---|
macOS 64 bits (x86_64) |
google-cloud-sdk-329.0.0-darwin-x86_64.tar.gz | 110,4 Mo | 1edda5cc0168e8c350e56ffbec1b5b78638e2c0a48e5dd88699d89ccfb35d688 |
macOS 64 bits (Arm64) |
google-cloud-sdk-329.0.0-darwin-arm.tar.gz | 34,4 Mo | 3c5af633ea8fclc00885049a81429bb20c2863126f301ee24696f3cfdbe492979 |
macOS 32 bits (x86) |
google-cloud-sdk-329.0.0-darwin-x86.tar.gz | 87,9 Mo | da72313f5762ddc56ce121e2f32c5af2fdf7c93a3667104ccd2e769d0f44d689 |
./google-cloud-sdk/bin/gcloud init
-
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 souhaitez activer le mode Lecteur d'écran, sélectionnez l'option Activer le mode Lecteur d'écran pour une expérience de lecture d'écran plus fluide. Pour en savoir plus sur l'expérience de lecteur d'écran du SDK Cloud, 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 programme d'installation installe toutes les dépendances nécessaires, y compris la version Python requise. Bien que le SDK Cloud utilise actuellement Python 3 par défaut, vous pouvez exploiter une installation Python existante si nécessaire. Pour ce faire, décochez l'option "Install Bundled Python"
Une fois l'installation terminée, le programme d'installation présente plusieurs options :
Vérifiez que les options suivantes sont bien sélectionnées :
- Start Google Cloud SDK Shell (Démarrer l'interface système du SDK Google Cloud)
- Exécutez
gcloud init
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.
- Si le SDK Cloud ne parvient pas à s'exécuter après l'installation de la version 274.0.0, reportez-vous à cette page de suivi de bug pour découvrir les dernières solutions.
- Si l'installation échoue parce que la commande
find
n'est pas reconnue, assurez-vous que votre variable d'environnementPATH
est définie de façon à inclure le dossier contenantfind
. Il s'agit généralement deC:\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 Google 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 s'agit 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
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:
Si l'API Google Compute Engine est activée,
gcloud init
vous permet de définir 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 bénéficier d'une expérience de lecture d'écran plus fluide, l'outil de ligne de commande gcloud possède une propriété
accessibility/screen_reader
.Pour activer cette propriété, exécutez la commande suivante :
gcloud config set accessibility/screen_reader true
Pour plus d'informations sur les fonctionnalités d'accessibilité disponibles avec l'outil de ligne de commande gcloud, consultez le guide Activer les fonctionnalités d'accessibilité.
Exécuter les commandes principales
Exécutez les commandes gcloud
ci-dessous 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
gcloud
affiche la liste des comptes identifiés :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
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
gcloud
affiche un résumé des informations concernant votre installation du SDK Cloud. Ce résumé comprend des informations sur votre système, les composants installés, le compte utilisateur actif et le projet en cours, ainsi que sur les propriétés de la configuration active.Pour afficher les informations concernant les commandes
gcloud
et d'autres sujets depuis la ligne de commande :gcloud help
Par exemple, pour afficher l'aide de
gcloud compute instances create
:gcloud help compute instances create
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 de ligne de commande gcloud pour obtenir une présentation de l'outil de ligne de commande gcloud. Vous y trouverez une présentation rapide des concepts clés, des conventions de commande et des conseils utiles.
- Consultez le guide de référence de l'outil de ligne de commande gcloud pour obtenir des informations détaillées sur chaque commande
gcloud
. Vous y trouverez des descriptions, des indicateurs et des exemples qui vous permettront d'effectuer diverses opérations. tâches sur Google Cloud. - Reportez-vous à l'aide-mémoire de l'outil de ligne de commande gcloud 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 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.
Profiter d'un essai gratuit