Cette page contient des instructions pour choisir et gérer une installation de Google Cloud CLI. Google Cloud CLI inclut les outils de ligne de commande gcloud
, gsutil
et bq
. Pour obtenir la liste des fonctionnalités de gcloud CLI, consultez la page Toutes les fonctionnalités.
Pour accéder aux API Google Cloud à l'aide d'un langage de programmation compatible, vous pouvez télécharger les bibliothèques clientes Cloud.
Instructions d'installation
Ces instructions concernent l'installation de Google Cloud CLI. Pour en savoir plus sur l'installation de composants supplémentaires, tels que les commandes de gcloud CLI en version alpha ou bêta, consultez la page Gérer les composants de gcloud CLI.
- Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3 (3.5 à 3.9). 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 :
Plate-forme Empaqueter Taille Somme de contrôle SHA256 Linux 64 bits (x86_64)
google-cloud-cli-445.0.0-linux-x86_64.tar.gz 187,6 Mo 1d482eea7d4f60a39ac17d06b42b194ddf9d8b2347ba8a0415b76d541f24a869 Linux 64 bits (ARM)
google-cloud-cli-445.0.0-linux-arm.tar.gz 115,5 Mo bbfe4267866086dd41b4ef93e53500622d67b17e9a7c150d628604747157b701 Linux 32 bits (x86)
google-cloud-cli-445.0.0-linux-x86.tar.gz 116,7 Mo 151295d294b5efd8219986f992c01645cb3d41da23e7d5cb6781e6c4925ba61b Sinon, pour télécharger le fichier d'archive Linux 64 bits, exécutez ce qui suit sur la ligne de commande :
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-445.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-cli-445.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-cli-445.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). Pour remplacer une installation existante, supprimez le répertoire
google-cloud-sdk
existant, puis extrayez l'archive au même emplacement. L'exemple suivant montre la commande pour le système Linux 32 bits. Si vous utilisez une autre plate-forme, ajustez la commande en conséquence :tar -xf google-cloud-cli-445.0.0-linux-x86.tar.gz
- Ajoutez gcloud CLI à votre PATH. Exécutez le script d'installation (à partir de la racine du dossier dans lequel vous l'avez extrait) à 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
(Facultatif) Pour envoyer des statistiques d'utilisation anonymes afin de nous aider à améliorer la gcloud CLI, répondezY
lorsque vous y êtes invité.
Pour ajouter gcloud CLI à votrePATH
et activer l'achèvement de commande, répondezY
lorsque vous y êtes invité. - Ouvrez un nouveau terminal pour que les modifications prennent effet.
- Pour initialiser gcloud CLI, exécutez la commande
gcloud init
: - Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
./google-cloud-sdk/bin/gcloud init
Contenu du package
gcloud CLI 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.
Avant d'installer gcloud CLI, assurez-vous que votre système d'exploitation remplit les conditions suivantes :
- Il s'agit d'une version d'Ubuntu qui n'est pas encore en fin de vie ou une version stable de Debian qui n'est pas encore en fin de vie
- Les packages ont été mis à jour récemment :
sudo apt-get update
apt-transport-https
etcurl
sont installés :sudo apt-get install apt-transport-https ca-certificates gnupg curl sudo
- Ajoutez l'URI de distribution de gcloud CLI en tant que source de package.
- Si votre distribution est compatible avec l'option de signature, exécutez la commande suivante :
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
Si votre distribution n'accepte pas l'option de signature, exécutez 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
- Si votre distribution est compatible avec l'option de signature, exécutez la commande suivante :
- Importez la clé publique de Google Cloud.
- Si la commande
apt-key
de votre distribution accepte l'argument--keyring
, exécutez la commande suivante :curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
Si la commande apt-key de votre distribution n'accepte pas l'argument
--keyring
, exécutez la commande suivante :curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
Si votre distribution (Debian 11 ou Ubuntu 21.10 ou versions ultérieures) n'est pas compatible avec
apt-key
, exécutez la commande suivante :curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.gpg
Si vous ne pouvez pas obtenir les dernières mises à jour en raison de l'expiration d'une clé, procurez-vous le dernier fichier de clé apt-get.gpg.
- Si la commande
- Mettez à jour et installez gcloud CLI :
sudo apt-get update && sudo apt-get install google-cloud-cli
Pour en savoir plus sur les autres optionsapt-get
, telles que la désactivation des invites ou des simulations, consultez les pages manapt-get
.Conseil Docker : Si vous installez gcloud CLI 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-cli -y
Si la commandeapt-key
n'est pas acceptée :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 | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
- (Facultatif) Installez l'un des
composants supplémentaires suivants :
google-cloud-cli
google-cloud-cli-anthos-auth
google-cloud-cli-app-engine-go
google-cloud-cli-app-engine-grpc
google-cloud-cli-app-engine-java
google-cloud-cli-app-engine-python
google-cloud-cli-app-engine-python-extras
google-cloud-cli-bigtable-emulator
google-cloud-cli-cbt
google-cloud-cli-cloud-build-local
google-cloud-cli-cloud-run-proxy
google-cloud-cli-config-connector
google-cloud-cli-datastore-emulator
google-cloud-cli-firestore-emulator
google-cloud-cli-gke-gcloud-auth-plugin
google-cloud-cli-kpt
google-cloud-cli-kubectl-oidc
google-cloud-cli-local-extract
google-cloud-cli-minikube
google-cloud-cli-nomos
google-cloud-cli-pubsub-emulator
google-cloud-cli-skaffold
google-cloud-cli-spanner-emulator
google-cloud-cli-terraform-validator
google-cloud-cli-tests
kubectl
Par exemple, le composant
google-cloud-cli-app-engine-java
peut être installé comme suit:sudo apt-get install google-cloud-cli-app-engine-java
- Pour commencer, exécutez
gcloud init
:gcloud init
Revenir à une version antérieure de gcloud CLI
Pour revenir à une version spécifique de gcloud CLI, où VERSION
est au format 123.0.0
, exécutez la commande suivante :
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
Les dix dernières versions sont toujours disponibles dans le dépôt.
REMARQUE : Pour les versions antérieures à 371.0.0, le nom du package est google-cloud-sdk
.
Contenu du package
gcloud CLI 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 34, 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.
- Mettez à jour DNF à l'aide des informations de dépôt de gcloud CLI. L'exemple de commande suivant concerne une installation compatible avec Red Hat Enterprise Linux 8. Pour une installation compatible avec Red Hat Enterprise Linux 7, remplacez
el8
parel7
dans la valeur debaseUrl
.sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-cli] name=Google Cloud CLI 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/rpm-package-key.gpg EOM
-
Si vous effectuez l'installation sur Fedora 34 ou 35, installez
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Installez gcloud CLI :
sudo dnf install google-cloud-cli
- (Facultatif) Installez l'un des composants supplémentaires suivants :
google-cloud-cli
google-cloud-cli-anthos-auth
google-cloud-cli-app-engine-go
google-cloud-cli-app-engine-grpc
google-cloud-cli-app-engine-java
google-cloud-cli-app-engine-python
google-cloud-cli-app-engine-python-extras
google-cloud-cli-bigtable-emulator
google-cloud-cli-cbt
google-cloud-cli-cloud-build-local
google-cloud-cli-cloud-run-proxy
google-cloud-cli-config-connector
google-cloud-cli-datastore-emulator
google-cloud-cli-firestore-emulator
google-cloud-cli-gke-gcloud-auth-plugin
google-cloud-cli-kpt
google-cloud-cli-kubectl-oidc
google-cloud-cli-local-extract
google-cloud-cli-minikube
google-cloud-cli-nomos
google-cloud-cli-pubsub-emulator
google-cloud-cli-skaffold
google-cloud-cli-spanner-emulator
google-cloud-cli-terraform-validator
google-cloud-cli-tests
kubectl
Par exemple, le composant
google-cloud-cli-app-engine-java
peut être installé comme suit:sudo dnf install google-cloud-cli-app-engine-java
- Pour commencer, exécutez
gcloud init
:gcloud init
Revenir à une version antérieure de gcloud CLI
Si vous souhaitez rétablir une version spécifique de gcloud CLI, où VERSION
est au format 123.0.0
, exécutez :
sudo dnf downgrade google-cloud-cli-VERSION
Les 10 dernières versions seront toujours disponibles dans le dépôt.
REMARQUE : Pour les versions antérieures à 371.0.0, le nom du package est google-cloud-sdk
.
-
Vérifiez que vous disposez d'une version compatible de Python :
-
Pour vérifier votre version actuelle de Python, exécutez
python3 -V
OUpython -V
. Les versions compatibles sont Python 3 (3.5 à 3.9). - Pour les versions 352.0.0 et ultérieures du SDK Cloud, le script d'installation principal propose d'installer Python 3.7 de CPython sur les Mac avec Intel.
-
Pour savoir comment choisir et configurer votre interpréteur Python, consultez
gcloud topic startup
.
-
Pour vérifier votre version actuelle de Python, exécutez
- Téléchargez l'un des éléments suivants :
-
Extrayez l'archive dans n'importe quel emplacement de votre système de fichiers, de préférence votre répertoire de base. Sur MacOS, vous pouvez effectuer cette opération en ouvrant le fichier d'archive
.tar.gz
téléchargé à l'emplacement choisi.Pour remplacer une installation existante, supprimez le répertoire
google-cloud-sdk
existant, puis extrayez l'archive au même emplacement. -
(Facultatif) Utilisez le script d'installation pour ajouter des outils de gcloud CLI à votre
PATH
.Vous pouvez également activer la saisie semi-automatique pour votre interface système, collecter des statistiques d'utilisation et installer Python 3.7.Exécutez le script (à partir de la racine du dossier que vous avez extrait à l'étape précédente) à 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. 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
Ouvrez un nouveau terminal pour que les modifications prennent effet. -
Pour initialiser gcloud CLI, exécutez la commande
gcloud init
: - Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Plate-forme | Empaqueter | Taille | Somme de contrôle SHA256 |
---|---|---|---|
macOS 64 bits
(x86_64) |
google-cloud-cli-445.0.0-darwin-x86_64.tar.gz | 121,7 Mo | 104178be77f383c4c1ee3501a11e5dbc4eda5f98d18c591ff411fb9eed51b8c7 |
macOS 64 bits
(ARM64, Apple M1 silicon) |
google-cloud-cli-445.0.0-darwin-arm.tar.gz | 118,8 Mo | fd1a0baee9c627e871641a40bcc643627c3b0fb0c9c73ce33b9d13e42c9adf30 |
macOS 32 bits
(x86) |
google-cloud-cli-445.0.0-darwin-x86.tar.gz | 101,4 Mo | 8bc26f14112a835ef2b5c73866df65d4c906ac3dfe3e62e33844832cedfbc8e3 |
./google-cloud-sdk/bin/gcloud init
-
La Google Cloud CLI fonctionne sous Windows 8.1 et versions ultérieures ainsi que Windows Server 2012 et versions ultérieures.
-
Téléchargez le programme d'installation de Google Cloud CLI.
Vous pouvez également 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 (3.5 à 3.9). Par défaut, la version Windows du SDK Cloud est fournie avec Python 3. 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 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.
- 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 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.
Autres options d'installation
En fonction de vos besoins de développement, vous pouvez utiliser une autre méthode d'installation de la gcloud CLI au lieu de l'installation recommandée:
- Vous utilisez la gcloud CLI avec des scripts ou l'intégration/le déploiement continu ? Téléchargez une archive avec versions gérées pour l'installation non interactive d'une version spécifique de gcloud CLI.
- Besoin d'exécuter gcloud CLI en tant qu'image Docker ? Utilisez l'image Docker de gcloud CLI pour obtenir la dernière version (ou une version spécifique) de gcloud CLI.
- Vous exécutez Ubuntu et préférez les mises à jour automatiques ? Utilisez un package snap pour installer la gcloud CLI.
- Pour les installations interactives sous Windows et macOS, et pour tous les autres cas d'utilisation, exécutez le programme d'installation interactif afin d'installer la dernière version de la gcloud CLI.
Gérer une installation
Après avoir installé la gcloud CLI, vous pouvez utiliser les commandes du groupe de commandes gcloud components
pour gérer votre installation. Cela inclut l'affichage des composants installés, l'ajout et la suppression de composants, ainsi que la mise à niveau vers une nouvelle version ou le retour à une version spécifique de la gcloud CLI.
Versions antérieures de gcloud CLI
Si vous avez besoin d'une autre version de gcloud CLI, installez la version actuelle en suivant les instructions décrites précédemment sur cette page, puis connectez-vous. Une fois connecté, vous pouvez télécharger les versions antérieures. Pour voir les versions triées par date, veillez à activer Trier et filtrer, puis cliquez sur la colonne Créée.
Versions Python compatibles
Google Cloud CLI nécessite Python 3 (3.5 à 3.9). Pour savoir comment choisir et configurer votre interpréteur Python, consultez gcloud topic startup
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