NOMBRE
gdcloud topic configurations: Ayuda complementaria para las configuraciones con nombre.
DESCRIPCIÓN
Las propiedades de la CLI de gdcloud se pueden almacenar en configuraciones con nombre, que son colecciones de pares clave-valor que influyen en el comportamiento de la CLI de gdcloud.
Los parámetros de configuración con nombre son beneficiosos si administras más de un proyecto u organización.
Las propiedades que se almacenan comúnmente en las configuraciones incluyen la URL de la consola de la organización y el ID del proyecto. Las configuraciones te permiten definir y habilitar estos y otros ajustes como un grupo.
Los datos de configuración se almacenan en $HOME/.config/gdcloud/
.
Las configuraciones son especialmente útiles si
+ trabajas con varios proyectos. Puedes crear una configuración independiente para cada proyecto.
- Usar varias URLs de la consola de la organización.
* Realizar tareas independientes en general: Por ejemplo, se puede usar una configuración para trabajar en el servicio de Object Storage en un proyecto y administrar un servicio no relacionado en otro proyecto.
Todos los comandos de la CLI de gcloud pueden leer la información de las propiedades almacenada en las configuraciones con nombre. Para establecer las propiedades, usa el comando gdcloud config set
.
Crear opciones de configuración
Los usuarios pueden definir las configuraciones con nombre o estas pueden estar integradas en la CLI de gcloud.
Las configuraciones definidas por el usuario tienen nombres en minúsculas, como johndoe
, default
, jeff-staging
o foo2
. Se definen con la siguiente expresión regular: ^[a-z][-a-z0-9]*$
.
Para crear una configuración nueva, ejecuta
gdcloud init
En esta guía, se explica cómo configurar tu primera configuración con nombre, crear una nueva configuración con nombre o volver a inicializar una configuración con nombre existente. Ten en cuenta que, si reinicializas una configuración existente, se quitarán todas sus propiedades existentes.
Para crear una configuración vacía nueva, ejecuta el siguiente comando:
gdcloud config configurations create [CONFIG_NAME]
Usa configuraciones
La CLI de gcloud debe tener, como máximo, una configuración activa que proporcione valores de propiedades. Las configuraciones inactivas no tienen efecto en las ejecuciones de la CLI de gdcloud. Para activar una configuración, ejecuta
gdcloud config configurations activate [CONFIG_NAME]
Para ver y cambiar las propiedades de tu configuración activa, ejecuta
gdcloud config list
gdcloud config set
Además, los comandos del grupo gdcloud config configurations
te permiten enumerar, activar, cambiar el nombre, describir y borrar configuraciones que pueden estar activas o no.
Puedes activar una configuración para una sola invocación de gdcloud con la marca --configuration my-config
.
Propiedades disponibles
accessibility
* screen_reader
* Si se configura, la CLI de gdcloud activa el lector de pantalla.
auth
* login_config_cert_path
* Ruta de acceso del archivo que almacena el certificado de configuración de acceso actual.
component_manager
* disable_update_check
* Si se configura, la CLI de gcloud no verifica automáticamente si hay actualizaciones.
core
* disable_prompts
* Si es verdadero, se supone la respuesta predeterminada para todas las indicaciones del usuario. Sin embargo, se genera un error para cualquier instrucción que requiera la entrada del usuario.
* format
* Establece el formato para imprimir los recursos de salida del comando. El valor predeterminado es un formato de salida legible para humanos específico del comando. Si se especifican core/format
y --format
, --format
tendrá prioridad. Los formatos admitidos se limitan a csv
, json
, table
, text
y yaml
.
* organization_console_url
* URL de la IU o la consola de la organización actual Ten en cuenta que debe comenzar con https //console.
. Por ejemplo, https //console.org-name.gdch.google.com
.
* project
* Nombre del proyecto actual.
storage
* s3_access_key_id
* ID de la clave de acceso del objeto de almacenamiento de S3. Es un identificador único para los usuarios.
* s3_custom_ca_certs_file
* Archivo de certificados personalizados para el objeto de almacenamiento de S3.
* s3_endpoint
* La URL del objeto de S3 consta de S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME
. S3_ENDPOINT
es la ubicación del bucket de almacenamiento de S3.
* s3_secret_access_key
* Clave privada del objeto de almacenamiento de S3 que se usa para firmar solicitudes.