Installer le SDK Cloud

Cette page contient des instructions sur le choix et la maintenance de l'installation du SDK Cloud. Le SDK Cloud inclut les outils de ligne de commande gcloud, gsutil et bq. Pour obtenir la liste des fonctionnalités du SDK Cloud, 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 du SDK Cloud. Pour en savoir plus sur l'installation de composants supplémentaires, tels que les commandes de l'outil gcloud en version alpha ou bêta, consultez la section Gérer les composants du SDK.

Linux
  1. Vérifiez que vous disposez d'une version compatible de Python. Le SDK Cloud nécessite Python 3 (3.5 à 3.8, 3.7 recommandé) et Python 2 (2.7.9 ou version ultérieure). Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la page gcloud topic startup.
  2. Téléchargez l'un des éléments suivants :
    Plate-forme Package Taille Somme de contrôle SHA256
    Linux 64 bits

    (x86_64)

    google-cloud-sdk-367.0.0-linux-x86_64.tar.gz 93,1 Mo 94328b9c6559a1b7ec2eeaab9ef0e4702215e16e8327c5b99718750526ae1efe
    Linux 64 bits

    (arm)

    google-cloud-sdk-367.0.0-linux-arm.tar.gz 90,5 Mo 3e16a36ce591cafbd1f399a4e96bbb014d7c300ccc6ad226f21c825a8c29afee
    Linux 32 bits

    (x86)

    google-cloud-sdk-367.0.0-linux-x86.tar.gz 90,5 Mo 50a9d0e949adb060b5c8daeee573dc2144edb59ac050ffa3b02ecb1a4759d2df

    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-sdk-367.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-367.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-367.0.0-linux-x86.tar.gz
  3. 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 et extrayez l'archive au même emplacement.
  4. Si vous souhaitez envoyer des statistiques d'utilisation anonymes pour contribuer à améliorer le SDK Cloud, répondez Y lorsque vous y êtes invité.
  5. Pour ajouter des outils de ligne de commande du SDK Cloud à votre PATH et activer l'achèvement de la commande, répondez Y lorsque vous y êtes invité.
  6. 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 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. Celles-ci sont décrites dans l'aide :
    ./google-cloud-sdk/install.sh --help
    
    Ouvrez un nouveau terminal pour que les modifications prennent effet.
  7. Pour initialiser le SDK, exécutez la commande gcloud init:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. 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.

Avant de commencer

Avant d'installer le SDK Cloud, assurez-vous que votre système d'exploitation remplit les conditions suivantes:

  • 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
  • apt-transport-https est installé:
    sudo apt-get install apt-transport-https ca-certificates gnupg
Installation
  1. Ajoutez l'URI de distribution du SDK Cloud 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
  2. 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 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.

  3. 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
          
  4. (Facultatif) Installez l'un des composants supplémentaires suivants :
    • 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
  5. Pour commencer, exécutez gcloud init :
    gcloud init

Revenir à une version antérieure du SDK Cloud

Pour revenir à une version spécifique du SDK Cloud, avec la 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 dix dernières versions sont 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
  1. Mettez à jour DNF à l'aide des informations de dépôt du SDK Cloud : 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 par el7 dans la valeur de baseUrl.
    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
    
  2. Si Python n'est pas déjà installé sur votre système, installez-le. Exemple :
    sudo dnf install python3
    ou
    sudo dnf install python
  3. Installez le SDK Cloud :
    sudo dnf install google-cloud-sdk
  4. (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
  5. 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
  1. Vérifiez que vous disposez d'une version compatible de Python :
    • Les versions compatibles sont Python 3 (3.5 à 3.8, 3.7 de préférence) 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. 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.
  2. Téléchargez l'un des éléments suivants :
  3. Plate-forme Package Taille Somme de contrôle SHA256
    macOS 64 bits

    (x86_64)

    google-cloud-sdk-367.0.0-darwin-x86_64.tar.gz 93,6 Mo 870ca3ca68b0a98af934cb4eae3f8910d1cd971b052eead53397325d9f140233
    macOS 64 bits

    (arm64, Apple M1 silicon)

    google-cloud-sdk-367.0.0-darwin-arm.tar.gz 93,6 Mo 1689b401444887ee527a5fe5c02cab8b4220e120b432c9244b94582d0ee7e002
    macOS 32 bits

    (x86)

    google-cloud-sdk-367.0.0-darwin-x86.tar.gz 97,4 Mo 0793754d58f1aca3a7f7b726714fe49817789b57a26eb84d98135da86b208ed5

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

      Pour remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant, puis extrayez l'archive au même emplacement.

    2. 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 installer éventuellement 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. 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.
    3. Exécutez gcloud init pour initialiser le SDK :
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Windows
  1. 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
        
  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é.

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

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

  5. 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 avez désinstallé le SDK Cloud, 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 du SDK Cloud que l'installation recommandée :

  • Vous utilisez le SDK Cloud avec des scripts ou dans le cadre d'une intégration continue/d'un déploiement continu ? Téléchargez une archive avec versions gérées pour l'installation non interactive d'une version spécifique du SDK Cloud.
  • Vous souhaitez exécuter le SDK Cloud sous forme d'image Docker ? Utilisez l'image Docker du SDK Cloud pour obtenir la dernière version (ou une version spécifique) du SDK Cloud.
  • Vous exécutez Ubuntu et préférez les mises à jour automatiques ? Installez le SDK Cloud à l'aide d'un package snap.
  • Pour les installations interactives sous Windows et macOS, et pour tous les autres cas d'utilisation, exécutez le programme d'installation interactif pour installer la dernière version du SDK Cloud.

Gérer une installation

Une fois que vous avez installé le SDK Cloud, vous pouvez utiliser les commandes du groupe de commandes gcloud components pour gérer votre installation. Vous pouvez entre autres afficher les composants installés, ajouter et supprimer des composants, et mettre à jour le SDK Cloud ou revenir à une version antérieure spécifique.

Anciennes versions du SDK Cloud

Si vous avez besoin d'une version plus ancienne du SDK Cloud, vous pouvez télécharger les versions précédentes.

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