Cette page vous explique comment initialiser gcloud CLI.
Après avoir installé gcloud CLI, effectuez les tâches de configuration initiales en exécutant gcloud init
. Vous pouvez également exécuter gcloud init
pour modifier vos paramètres ou créer une configuration.
gcloud init
effectue les étapes de configuration suivantes :
- Autorise gcloud CLI à utiliser les identifiants de votre compte utilisateur pour accéder à Google Cloud ou vous permet de sélectionner un compte si vous avez déjà autorisé l'accès
- Il définit une configuration gcloud CLI et un ensemble de propriétés de base, y compris le compte actif de l'étape ci-dessus, le projet actuel et, le cas échéant, la région et la zone Compute Engine par défaut.
Vous pouvez exécuter les commandes suivantes à la place de gcloud init
:
Commande | Description |
---|---|
gcloud auth login
|
Autorise avec un compte utilisateur sans définir de configuration |
gcloud auth activate-service-account
|
Autorise 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]
|
Créer et gérer les configurations et les propriétés de gcloud CLI |
Initialiser gcloud CLI
Pour initialiser gcloud CLI:
Exécutez
gcloud init
:gcloud init
Dans une session de terminal à distance, vous pouvez ajouter l'indicateur
--no-launch-browser
pour empêcher la commande de lancer un flux d'autorisation basé sur un navigateur, si nécessaire :gcloud init --no-launch-browser
Créez ou sélectionnez une configuration si vous y êtes invité.
Si vous initialisez une nouvelle installation de gcloud CLI,
gcloud init
crée une configuration nomméedefault
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.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
--no-launch-browser
et que la connexion est requise, vous devez ensuite copier et coller l'URL d'autorisation fournie dans une autre fenêtre de 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é.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:
Choisissez une zone 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 verrez pas cette étape.
gcloud init
définit les propriétésregion
etzone
dans la configuration en utilisant 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
.
Étapes suivantes
- Pour en savoir plus sur l'autorisation des outils, consultez Autoriser la CLI gcloud.
- Pour en savoir plus sur l'autorisation des Identifiants par défaut de l'application (ADC) pour les bibliothèques clientes Cloud (et sur les bibliothèques clientes des API Google), consultez la section Fournir des identifiants pour les identifiants par défaut de l'application.
- Pour en savoir plus sur la gestion des configurations, consultez gcloud CLI configurations.
- Pour en savoir plus sur la gestion des propriétés, consultez la page Propriétés de gcloud CLI.