Démarrage rapide pour Linux

Cette page explique comment installer le SDK Google Cloud, l'initialiser et exécuter les principales commandes gcloud depuis la ligne de commande.

Avant de commencer

  1. Créer un projet Google Cloud Platform, si vous n'en possédez pas encore.

  2. Le SDK Cloud nécessite Python. La compatibilité est assurée pour les versions 3.5 à 3.7, ainsi que 2.7.9 et les versions ultérieures. Pour vérifier quelle version de Python est installée sur votre système, utilisez la commande :

    python -V
    
  3. Téléchargez le fichier d'archive le mieux adapté à votre système d'exploitation. La plupart des machines exécutent le package 64 bits. Pour effectuer une vérification, exécutez uname -m afin de savoir si vous utilisez un système 64 bits.

    Plate-forme Package Taille Somme de contrôle SHA256
    Linux 64 bits

    (x86_64)

    google-cloud-sdk-302.0.0-linux-x86_64.tar.gz 78,5 Mo 59cfb58e52d93ef4a39d475f6c5c9c0f13ad229ea7f871a8be41e6a2c0a76e4b
    Linux 32 bits

    (x86)

    google-cloud-sdk-302.0.0-linux-x86.tar.gz 76,8 Mo f35e1973f9a02a1dee4bd3a9f925aed468e0f78324114bc492c21fb9457d51b5

    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-302.0.0-linux-x86_64.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-302.0.0-linux-x86.tar.gz
    
  4. Extrayez l'archive dans n'importe quel emplacement de votre système de fichiers, de préférence votre dossier de base. Sous Linux, vous pouvez extraire le fichier d'archive en exécutant la commande suivante :

    tar zxvf [ARCHIVE_FILE] google-cloud-sdk
    
  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 bash et la collecte des statistiques d'utilisation pendant le processus d'installation. Exécutez le script en utilisant cette commande :

    ./google-cloud-sdk/install.sh
    

    Redémarrez le terminal pour que les modifications prennent effet.

    Vous pouvez également appeler le SDK Cloud après avoir extrait l'archive téléchargée en appelant ses exécutables via le chemin complet.

Initialiser le SDK

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

Pour initialiser le SDK, procédez comme suit :

  1. Saisissez la commande suivante dans une invite :

    gcloud init
    

    Conseil de dépannage : Si vous rencontrez une erreur indiquant que la commande gcloud est introuvable, exécutez ./google-cloud-sdk/install.sh pour utiliser le script d'installation : celui-ci ajoute les outils du SDK Cloud à votre PATH. Redémarrez le terminal pour que les modifications prennent effet.

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

  4. Dans l'invite de commande, sélectionnez un projet Cloud Platform 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:
    
  5. 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]
    
  6. (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 des commandes gcloud clés

Exécutez les commandes gcloud ci-dessous pour afficher des informations relatives à votre installation du SDK :

  1. 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
    
  2. Pour répertorier les propriétés de la configuration active du SDK :

    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
    
  3. Pour afficher les informations relatives à 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 relatives à votre système, aux composants du SDK installés, au compte utilisateur actif et au projet en cours, ainsi qu'aux propriétés de la configuration active du SDK.

  4. 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 gcloud pour une présentation de l'outil de ligne de commande gcloud, avec une introduction rapide aux concepts clés et conventions de commande, ainsi que des conseils utiles.
  • Consultez le guide de référence gcloud pour obtenir des informations détaillées sur chaque commande gcloud. Vous y trouverez des descriptions, des options et des exemples qui vous permettront d'effectuer diverses tâches sur Google Cloud Platform.
  • 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.