Gérer les configurations de gcloud CLI

Une configuration est un ensemble nommé de propriétés de Google Cloud CLI. Ces propriétés sont des paires clé/valeur, organisées en sections, qui régissent le comportement de gcloud CLI.

Les propriétés généralement stockées dans les configurations incluent la zone Compute Engine par défaut, le niveau de détail, les rapports d'utilisation, l'ID de projet et un compte utilisateur ou de service actif. Les configurations permettent de définir et d'activer ces paramètres et d'autres en tant que groupe.

Les configurations sont stockées dans votre répertoire de configuration utilisateur (généralement ~/.config/gcloud sous macOS et Linux, ou %APPDATA%\gcloud sous Windows). Vous pouvez trouver l'emplacement du répertoire de configuration en exécutant gcloud info --format='value(config.paths.global_config_dir)'. Vous pouvez modifier le répertoire de configuration en définissant la variable d'environnement CLOUDSDK_CONFIG. Notez également que le répertoire de configuration doit être activé en écriture. Toutefois, si vous utilisez Cloud Shell, vos préférences de gcloud CLI sont stockées dans un dossier temporaire tmp, qui est défini uniquement pour votre onglet Cloud Shell actuel. Elles ne sont pas conservées d'une session à l'autre.

Si vous disposez de plusieurs configurations, vous pouvez choisir de basculer de l'une à l'autre, ou d'exécuter des commandes avec une configuration spécifique (à l'aide de l'option --configuration). Pour plus d'informations sur le changement de configuration, reportez-vous à la section ci-dessous concernant l'activation des configurations.

Pour en savoir plus sur les configurations depuis la ligne de commande (et obtenir une liste complète des propriétés disponibles ainsi que des sections où elles se trouvent), exécutez la commande gcloud topic configurations.

Configuration par défaut

La gcloud CLI vous permet de démarrer avec une configuration unique nommée default. Vous pouvez définir des propriétés dans votre configuration en exécutant la commande gcloud init ou en exécutant directement gcloud config set.

Par exemple, pour désactiver les invites de script, exécutez cette commande :

gcloud config set disable_prompts true

Configurations multiples

La configuration unique default convient à de nombreux cas d'utilisation. Vous pouvez toutefois créer des configurations supplémentaires et basculer entre elles selon vos besoins à l'aide de la commande gcloud config configurations activate. La configuration initiale default n'a aucune spécificité. Elle est créée à des fins de commodité. Vous pouvez nommer cette configuration et toute configuration supplémentaire comme vous le souhaitez.

Les configurations multiples sont utiles dans les contextes suivants :

  • Utiliser plusieurs projets : vous pouvez créer une configuration distincte pour chaque projet et basculer entre les configurations selon les besoins
  • Utiliser plusieurs comptes d'autorisation
  • Effectuer des tâches généralement indépendantes : vous pouvez, par exemple, utiliser une configuration pour travailler sur une application Google App Engine dans un projet et gérer des instances Compute Engine non liées dans un autre projet

Créer une configuration

Pour créer une configuration, exécutez la commande gcloud config configurations create :

gcloud config configurations create [NAME]

Vous devez activer la nouvelle configuration après sa création pour pouvoir l'utiliser.

Activer une configuration

Une seule de vos multiples configurations peut être active à un moment donné. La configuration active est celle dont les propriétés vont régir le comportement de la gcloud CLI.

Pour activer une nouvelle configuration ou basculer vers une nouvelle configuration active, exécutez gcloud config configurations activate :

gcloud config configurations activate [NAME]

gcloud config list vous indique toujours les propriétés de la configuration active.

Pour changer de configuration active pour un appel de commande individuel, vous pouvez utiliser l'option --configuration avec n'importe quelle commande de CLI gcloud :

gcloud auth list --configuration=[CONFIGURATION_NAME]

Pour modifier la configuration active de toutes les commandes de votre terminal actuel, vous pouvez définir la variable d'environnement CLOUDSDK_ACTIVE_CONFIG_NAME sur le nom de la configuration à utiliser.

Automatiser le changement de configuration

Pour faciliter la modification des configurations, vous pouvez utiliser des outils tels que direnv et ondir pour basculer automatiquement entre les configurations lorsque vous changez de répertoire de travail. Pour ce faire, vous pouvez définir les variables d'environnement nécessaires (telles que CLOUDSDK_ACTIVE_CONFIG_NAME) dans le fichier .envrc situé dans le répertoire racine de votre projet.

Répertorier les configurations

Pour répertorier les configurations de votre installation de gcloud CLI, exécutez gcloud config configurations list:

gcloud config configurations list

La gcloud CLI répertorie les configurations et indique celle qui est active:

NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

Définir les propriétés de configuration

Pour définir les propriétés de la configuration active ou annuler leur définition, exécutez gcloud config set ou gcloud config unset :

gcloud config set project [PROJECT]

gcloud config unset project

Les propriétés peuvent également être définies via des variables d'environnement appelées CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Par exemple, vous pouvez définir les propriétés core/project et compute/zone comme suit :

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Afficher les propriétés de configuration

Pour afficher les propriétés d'une configuration, exécutez gcloud config configurations describe :

gcloud config configurations describe [NAME]

Sinon, pour afficher les propriétés de la configuration active :

gcloud config list

La CLI gcloud affiche les propriétés de configuration :

is_active: false
name: default
properties:
  compute:
    region: us-east1
    zone: us-east1-b
  core:
    account: user@google.com
    project: example-project

Supprimer une configuration

Pour supprimer une configuration, exécutez la commande gcloud config configurations delete :

gcloud config configurations delete [NAME]

Vous ne pouvez pas supprimer la configuration active. Utilisez gcloud config configurations activate si nécessaire pour passer à une autre configuration avant la suppression.

Étapes suivantes