NAME
gdcloud topic configurations : aide supplémentaire pour les configurations nommées.
DESCRIPTION
Les propriétés de la CLI gdcloud peuvent être stockées dans des configurations nommées, qui sont des collections de paires clé-valeur qui influencent le comportement de la CLI gdcloud.
Les configurations nommées sont utiles si vous gérez plusieurs projets ou organisations.
Les propriétés couramment stockées dans les configurations incluent l'URL de la console de l'organisation et l'ID du projet. Les configurations vous permettent de définir et d'activer ces paramètres et d'autres en tant que groupe.
Les données de configuration sont stockées dans $HOME/.config/gdcloud/.
Les configurations sont particulièrement utiles si vous
: + travaillez sur plusieurs projets. Vous pouvez créer une configuration distincte pour chaque projet.
- Utilisez plusieurs URL de console d'organisation.
* Effectuez des tâches généralement indépendantes. Par exemple, une configuration peut être utilisée pour travailler sur le service Object Storage dans un projet et gérer un service non lié dans un autre projet.
Les informations sur les propriétés stockées dans les configurations nommées sont lisibles par toutes les commandes de la CLI gdcloud. Pour définir les propriétés, utilisez la commande gdcloud config set.
Créer des configurations
Les configurations nommées peuvent être définies par les utilisateurs ou intégrées à la CLI gdcloud.
Les configurations définies par l'utilisateur comportent des noms en minuscules, tels que johndoe, default, jeff-staging ou foo2. Elles sont définies par l'expression régulière suivante : ^[a-z][-a-z0-9]*$.
Pour créer une configuration, exécutez
gdcloud init
Cette procédure vous explique comment configurer votre première configuration nommée, créer une configuration nommée ou réinitialiser une configuration nommée existante. Notez que la réinitialisation d'une configuration existante supprime toutes ses propriétés existantes.
Pour créer une configuration vide, exécutez
gdcloud config configurations create [CONFIG_NAME]
Utiliser des configurations
La CLI gdcloud ne doit comporter qu'une seule configuration active qui fournit des valeurs de propriété. Les configurations inactives n'ont aucun effet sur les exécutions de la CLI gdcloud. Pour activer une configuration, exécutez
gdcloud config configurations activate [CONFIG_NAME]
Pour afficher et modifier les propriétés de votre configuration active, exécutez
gdcloud config list
gdcloud config set
De plus, les commandes du groupe gdcloud config configurations vous permettent de lister, d'activer, de renommer, de décrire et de supprimer des configurations qui peuvent être actives ou non.
Vous pouvez activer une configuration pour un seul appel gdcloud à l'aide de l'indicateur --configuration my-config.
Propriétés disponibles
accessibility
* screen_reader
* Si cette option est définie, la CLI gdcloud active le lecteur d'écran.
auth
* login_config_cert_path
* Chemin d'accès au fichier qui stocke le certificat de configuration de connexion actuel.
component_manager
* disable_update_check
* Si cette option est définie, la CLI gdcloud ne recherche pas automatiquement les mises à jour.
core
* disable_prompts
* Si la valeur est "True", la réponse par défaut est supposée pour toutes les invites utilisateur. Toutefois, une erreur est générée pour toutes les invites nécessitant une entrée utilisateur.
* format
* Définissez le format d'impression des résultats de la commande. La valeur par défaut est un format de sortie convivial spécifique à la commande. Si core/format et --format sont spécifiés, --format est prioritaire. Les formats compatibles sont limités à csv, json, table, text, yaml.
* organization_console_url
* URL de l'interface utilisateur/console de l'organisation actuelle. Notez qu'elle doit commencer par https //console.. Par exemple, https //console.org-name.gdch.google.com.
* project
* Nom du projet actuel.
storage
* s3_access_key_id
* ID de clé d'accès de l'objet de stockage S3. Il s'agit d'un identifiant unique pour les utilisateurs.
* s3_custom_ca_certs_file
* Fichier de certificats personnalisés pour l'objet de stockage S3.
* s3_endpoint
* L'URL de l'objet S3 se compose de S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME. S3_ENDPOINT correspond à l'emplacement du bucket de stockage S3.
* s3_region
* Nom de la région S3 où se trouve le bucket de stockage S3. La valeur par défaut est us-east-1.
* s3_secret_access_key
* Clé privée de l'objet de stockage S3 utilisé pour signer les requêtes.