NOM
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 généralement stockées dans les configurations incluent l'URL de la console d'administration 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.
- Utiliser plusieurs URL de la console d'organisation.
* Effectuer 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 gcloud CLI. 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 ont 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
Ce guide vous explique comment configurer votre première configuration nommée, en créer une, ou réinitialiser une configuration nommée existante. Notez que la réinitialisation d'une configuration existante supprime toutes ses propriétés.
Pour créer une configuration vide, exécutez la commande suivante :
gdcloud config configurations create [CONFIG_NAME]
Utiliser les configurations
La CLI gdcloud ne doit comporter qu'une seule configuration active fournissant 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 appliquée à toutes les invites utilisateur. Toutefois, une erreur est générée pour les invites qui nécessitent une saisie de l'utilisateur.
* format
* Définissez le format d'impression des ressources de résultat de la commande. La valeur par défaut est un format de sortie convivial spécifique à la commande. Si les options core/format et --format sont spécifiées, --format prévaut. Les formats acceptés sont limités à csv, json, table, text et yaml.
* organization_console_url
* URL de l'interface utilisateur/console de l'organisation actuelle. Notez qu'il doit commencer par https //console.. Par exemple, https //console.org-name.gdch.google.com.
* project
* Nom actuel du projet.
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_secret_access_key
* Clé privée de l'objet de stockage S3 utilisé pour signer les requêtes.