Documentation du SDK Google Cloud

Le SDK Google Cloud est un ensemble d’outils utilisables pour gérer les ressources et les applications hébergées sur Google Cloud Platform. Il comprend, entre autres, les outils de ligne de commande gcloud, gsutil et bq. L'outil de ligne de commande gcloud est téléchargé avec le SDK Cloud. Vous trouverez un guide complet sur la CLI gcloud dans la présentation de gcloud.

De plus, la documentation de référence gcloud décrit toutes les fonctionnalités de la CLI gcloud.

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

Linux
  1. Le SDK Cloud nécessite Python. La compatibilité est assurée à partir des versions 3.5 et ultérieures, ou 2.7.9 et ultérieures.

    python2 --version
  2. Téléchargez l'un des packages ci-dessous :
  3. Plate-forme Package Taille Somme de contrôle SHA256
    Linux 64 bits

    (x86_64)

    google-cloud-sdk-280.0.0-linux-x86_64.tar.gz 56,3 Mo 11950f1db216ec7dc3abaf80722fb80518c38e279bd76b6924326fe660c209cf
    Linux 32 bits

    (x86)

    google-cloud-sdk-280.0.0-linux-x86.tar.gz 54,5 Mo dfc2bc5d016e1c20d43c7bcd2f5be3063c31b924971598838978fbe25d6ac341

  4. Extrayez le contenu du fichier vers n’importe quel emplacement de votre système de fichiers. Si vous souhaitez remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant et extrayez l'archive au même emplacement.
  5. Facultatif. Exécutez le script d'installation pour ajouter des outils du SDK Cloud à votre chemin. 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 en utilisant cette commande :
        ./google-cloud-sdk/install.sh
        
    Ouvrez un nouveau terminal pour que les modifications prennent effet.
  6. Exécutez gcloud init pour initialiser le SDK :
  7.     ./google-cloud-sdk/bin/gcloud init
        
  8. Facultatif. Installez des composants supplémentaires à l'aide du gestionnaire de composants.
Debian/Ubuntu

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.

Vous pouvez installer le SDK Cloud à partir d'un package Debian/Ubuntu pour l'ensemble des versions officielles d'Ubuntu qui ne sont pas arrivées en fin de vie et des versions stables de Debian à partir de Wheezy.

Remarque : Si vous utilisez une instance sur Google Compute Engine, le SDK Cloud est installé par défaut. Vous pouvez toujours installer manuellement le SDK Cloud en suivant les instructions ci-dessous.

  1. 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
    Remarque : Assurez-vous que apt-transport-https est installé :
    sudo apt-get install apt-transport-https ca-certificates gnupg
  2. 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 -
  3. Mettez à jour le SDK Cloud, puis installez-le :
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Remarque : Pour en savoir plus sur d'autres options apt-get, telles que la désactivation des invites ou les simulations, consultez les pages man relatives à apt-get.
  4. Vous avez la possibilité d'installer n'importe lequel 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
  5. Pour commencer, exécutez gcloud init :
    gcloud init
Red Hat/CentOS

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

Remarque : Si vous utilisez une instance sur Google Compute Engine, le SDK Cloud est installé par défaut.

  1. Mettez à jour YUM à 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
        

    Important : La deuxième ligne de gpgkey doit être en retrait comme indiqué ici.

  2. Installez le SDK Cloud :
    yum install google-cloud-sdk
    Remarque : Pour en savoir plus sur d'autres options yum, telles que la désactivation des invites ou les simulations, consultez les pages man relatives à yum.
  3. Vous avez la possibilité d'installer n'importe lequel 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 :

    yum install google-cloud-sdk-app-engine-java
  4. Pour commencer, exécutez gcloud init :
    gcloud init
macOS
  1. Le SDK Cloud nécessite Python. La compatibilité est assurée à partir des versions 3.5 et ultérieures, ou 2.7.9 et ultérieures. Les versions modernes de macOS incluent la version de Python requise pour le SDK Google Cloud.
  2.     python -V
        
  3. Téléchargez l'un des packages ci-dessous :
  4. Plate-forme Package Taille Somme de contrôle SHA256
    macOS 64 bits

    (x86_64)

    google-cloud-sdk-280.0.0-darwin-x86_64.tar.gz 49,0 Mo c9554507bc217a503b42bef7dfa72179bae57ad7e4e696af4205c50b373d3576
    macOS 32 bits

    (x86)

    google-cloud-sdk-280.0.0-darwin-x86.tar.gz 47,9 Mo 50c80701e1307ccd8e78fba34d34cec446cf24ee0a7ef30cef260c72676c0980

  5. Extrayez le contenu du fichier vers n’importe quel emplacement de votre système de fichiers. Si vous souhaitez remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant et extrayez l'archive au même emplacement.
  6. Facultatif. Exécutez le script d'installation pour ajouter des outils du SDK Cloud à votre chemin. 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 en utilisant cette commande :
        ./google-cloud-sdk/install.sh
        
    Ouvrez un nouveau terminal pour que les modifications prennent effet.
  7. Exécutez gcloud init pour initialiser le SDK :
  8.     ./google-cloud-sdk/bin/gcloud init
        
  9. 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.

    Le SDK Cloud nécessite Python. La compatibilité est assurée à partir des versions 3.5 et ultérieures, ou 2.7.9 et ultérieures.

    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 2 par défaut, vous pouvez exploiter une installation Python existante si nécessaire. Pour ce faire, décochez l'option "Install Bundled Python" (installation de Python groupée).

  3. Une fois l'installation terminée, acceptez les options suivantes :

    • Démarrer l'interface système du SDK Cloud
    • Exécuter gcloud init

    Le programme d'installation affiche une fenêtre de terminal, puis exécute la commande gcloud init.

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

Installer les dernières bibliothèques clientes Google Cloud

Vous pouvez télécharger des bibliothèques clientes Cloud pour les langages compatibles.

Facultatif : Activer les fonctionnalités d'accessibilité

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

En savoir plus