Démarrage rapide pour Debian et Ubuntu

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

Assurez-vous que votre système d'exploitation est l'un des suivants :

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

Ensuite, effectuez les étapes suivantes :

# Add the Cloud SDK distribution URI as a package source
    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    # Import the Google Cloud Platform public key
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    # Update the package list and install the Cloud SDK
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    

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
    

Résoudre les problèmes d'installation

Si vous ne parvenez 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 apt-key de votre distribution n'accepte pas l'argument --keyring, exécutez cette commande à la place :

# Add the Cloud SDK distribution URI as a package source
    echo "deb http://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    # Import the Google Cloud Platform public key
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    # Update the package list and install the Cloud SDK
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    

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
        

    Remarque : Si vous rencontrez une erreur signalant que la commande gcloud est introuvable, reportez-vous à l'étape 5 de la section ci-dessus.

    Remarque : Pour empêcher la commande de lancer un navigateur Web, utilisez gcloud init --console-only. Pour procéder à l'autorisation sans navigateur Web et de manière non interactive, créez un compte de service avec les champs d'application appropriés à l'aide de la console Google Cloud Platform et utilisez gcloud auth activate-service-account avec le fichier de clé JSON correspondant.

  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.

  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 les principales commandes gcloud

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'indicateurs et d'arguments de commande, ainsi que des exemples d'utilisation.

Étapes suivantes

  • 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 indicateurs et des exemples qui vous permettront d'effectuer diverses tâches sur Google Cloud Platform.
  • Installez des packages APT supplémentaires pour le SDK Cloud.