Gérer les propriétés de la CLI gcloud

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Les propriétés sont des paramètres qui régissent le comportement de la CLI gcloud.

Vous pouvez utiliser des propriétés pour définir un paramètre par produit ou service, tel que le compte utilisé par la CLI gcloud pour l'autorisation, la région par défaut à utiliser avec les ressources Compute Engine, ou la possibilité de désactiver les vérifications automatiques des mises à jour des composants de la CLI gcloud. Vous pouvez également utiliser les propriétés pour définir les préférences de gcloud de la CLI, telles que le niveau de verbosité et la configuration d'invite pour les commandes de CLI gcloud.

Propriétés et options

La CLI gcloud est compatible avec certains indicateurs globaux et commandes de commande qui ont le même effet que les propriétés de la CLI gcloud. Par exemple, la CLI gcloud accepte aussi bien l'option --project que la propriété project. Les propriétés permettent de conserver les mêmes paramètres lors de l'exécution des commandes, tandis que les indicateurs affectent le comportement des commandes appel par appel. Notez que les indicateurs remplacent les propriétés lorsque les deux sont définis.

Configurations

Une configuration est un ensemble nommé de propriétés de CLI gcloud. La CLI gcloud utilise une configuration nommée default comme configuration active initiale. La configuration default convient à la plupart des cas d'utilisation. Cependant, vous pouvez également créer des configurations supplémentaires et basculer entre elles selon vos besoins.

Répertorier les propriétés

Pour répertorier les propriétés de la configuration active, exécutez gcloud config list :

gcloud config list

La CLI gcloud renvoie la liste des propriétés :

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Définir des propriétés

Pour définir une propriété dans la configuration active, exécutez gcloud config set. L'exemple suivant définit la propriété project, où PROJECT_ID est l'ID unique de votre projet.

gcloud config set project PROJECT_ID

Pour définir des propriétés qui ne figurent pas dans la section des propriétés core, vous devez spécifier la section suivie d'une barre oblique avant le nom de la propriété. L'exemple suivant définit le nom de la zone sur us-east1-b.

gcloud config set compute/zone us-east1-b

Définir des propriétés à l'aide de variables d'environnement

Vous pouvez également définir des propriétés à l'aide de variables d'environnement. Chaque propriété est associée à une variable d'environnement que vous pouvez utiliser pour la définir. Le nom de la variable d'environnement suit le modèle 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=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Annuler la définition de propriétés

Pour annuler la définition d'une propriété dans la configuration active, utilisez gcloud config unset :

gcloud config unset disable_usage_reporting

Propriétés disponibles

Pour obtenir la liste de toutes les propriétés, exécutez la commande gcloud topic configurations ou gcloud config set --help et recherchez la section "Available Properties" (propriétés disponibles).

Étapes suivantes