Initialiser le SDK Cloud

Cette page explique comment initialiser le SDK Google Cloud.

Après avoir installé le SDK Cloud, l'étape suivante consiste généralement à exécuter la commande gcloud init pour effectuer les tâches de configuration initiale. Vous pouvez également exécuter gcloud init ultérieurement pour modifier vos paramètres ou créer une configuration.

gcloud init effectue les étapes de configuration suivantes :

  • Autorise les outils du SDK Cloud à utiliser les identifiants de votre compte utilisateur pour accéder à Google Cloud, ou permet de sélectionner un compte si vous avez déjà autorisé l'accès.
  • Définit une configuration du SDK Cloud et un ensemble de propriétés de base, en particulier le compte actif de l'étape ci-dessus, le projet actuel et, le cas échéant, la région et la zone Google Compute Engine par défaut

Vous pouvez exécuter les commandes suivantes à la place de gcloud init :

Commande Description
gcloud auth login Pour autoriser l'authentification avec un compte utilisateur sans définir de configuration
gcloud auth activate-service-account Pour autoriser l'authentification avec un compte de service au lieu d'un compte utilisateur

Utile pour autoriser de manière non interactive et sans navigateur Web

gcloud config [COMMAND]
gcloud config configurations [COMMAND]
Pour créer et gérer les configurations et les propriétés du SDK Cloud

Run gcloud init (Exécuter gcloud init)

Pour initialiser le SDK Cloud :

  1. Exécutez gcloud init :

    gcloud init
    

    Dans une session de terminal à distance, vous pouvez ajouter l'indicateur --console-only pour empêcher la commande de lancer un flux d'autorisation basé sur un navigateur, si nécessaire :

    gcloud init --console-only
    
  2. Créez ou sélectionnez une configuration si vous y êtes invité.

    Si vous initialisez une nouvelle installation du SDK Cloud, gcloud init crée une configuration nommée default et la définit comme configuration active. Si vous avez des configurations existantes, gcloud init vous invite à choisir l’une des trois options suivantes : réinitialiser la configuration active, basculer vers une autre configuration et la réinitialiser, ou en créer une.

  3. Terminez l'étape d'autorisation lorsque vous y êtes invité.

    Selon que vous avez ou non déjà autorisé l'accès à Google Cloud, vous pouvez être invité à vous connecter et à accorder l'accès dans un navigateur Web, ou à sélectionner un compte existant.

    Si vous avez utilisé l'indicateur --console-only et que la connexion est requise, vous devez ensuite couper et coller l'URL d'autorisation fournie dans une autre fenêtre du navigateur, puis suivre les invites fournies.

    Lorsque cette étape est terminée, gcloud init définit la propriété account dans la configuration sur le compte spécifié.

  4. Choisissez un projet Google Cloud en cours si vous y êtes invité.

    Si vous n'avez accès qu'à un seul projet, y compris le projet par défaut pour votre compte utilisateur, gcloud init le sélectionne pour vous. Sinon, vous pouvez sélectionner un projet dans une liste de projets pour lesquels vous disposez du rôle Propriétaire, Éditeur ou Lecteur. gcloud init définit la propriété project dans la configuration sur la valeur de votre choix. 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. Choisissez une zone Google Compute Engine par défaut si vous y êtes invité.

    Si l'API Compute Engine n'est pas activée ou si vous avez déjà une zone par défaut dans vos métadonnées au niveau du projet, vous ne voyez pas cette étape. gcloud init définit les propriétés region et zone dans la configuration à l'aide de la zone choisie.

Lorsque la commande gcloud init a terminé, elle affiche les propriétés de la configuration active sur le terminal :

[compute]
region = us-east1
zone = us-east1-b
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project

Vous pouvez afficher ces propriétés à tout moment en utilisant la commande gcloud config list.

Étape suivante