NOMBRE
Configuraciones de temas de gdcloud: ayuda complementaria para 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.
Las configuraciones con nombre son útiles si gestionas más de un proyecto u organización.
Entre las propiedades que se suelen almacenar en las configuraciones se incluyen la URL de la consola de organización y el ID de 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. Puede crear una configuración independiente para cada proyecto.
- Usar varias URLs de la consola de organización.
* Realizar tareas generalmente independientes Por ejemplo, se puede usar una configuración para trabajar en el servicio Object Storage de un proyecto y gestionar un servicio no relacionado en otro proyecto.
Todos los comandos de la CLI de gdcloud pueden leer la información de la propiedad almacenada en configuraciones con nombre. Para definir las propiedades, usa el comando gdcloud config set.
Crear configuraciones
Los usuarios pueden definir configuraciones con nombre o bien pueden estar integradas en la CLI de gdcloud.
Las configuraciones definidas por el usuario tienen nombres en minúsculas, como johndoe, default, jeff-staging o foo2. Se definen mediante la siguiente expresión regular: ^[a-z][-a-z0-9]*$.
Para crear una configuración, ejecuta el siguiente comando:
gdcloud init
En este artículo se explica cómo configurar tu primera configuración con nombre, crear una nueva o reinicializar una que ya tengas. Ten en cuenta que, si reinicializas una configuración, se eliminarán todas sus propiedades.
Para crear una configuración vacía, ejecute el siguiente comando:
gdcloud config configurations create [CONFIG_NAME]
Usar configuraciones
La CLI de gdcloud debe tener como máximo una configuración activa que proporcione valores de propiedad. Las configuraciones inactivas no tienen ningún 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 eliminar configuraciones que pueden estar activas o no.
Puedes activar una configuración para una sola invocación de gdcloud mediante la marca --configuration my-config.
Propiedades disponibles
accessibility
* screen_reader
* Si se define, la CLI de gdcloud activa el lector de pantalla.
auth
* login_config_cert_path
* Ruta del archivo que almacena el certificado de configuración de inicio de sesión actual.
component_manager
* disable_update_check
* Si se define, la CLI de gdcloud no buscará actualizaciones automáticamente.
core
* disable_prompts
* Si el valor es True, se presupone la respuesta predeterminada para todas las peticiones de los usuarios. Sin embargo, se produce un error en las peticiones que requieren que el usuario introduzca datos.
* format
* Define el formato de los recursos de salida de los comandos de impresión. El valor predeterminado es un formato de salida legible por humanos específico del comando. Si se especifican core/format y --format, --format tiene prioridad. Los formatos admitidos son csv, json, table, text y yaml.
* organization_console_url
* URL de la interfaz de usuario o la consola de la organización actual. Ten en cuenta que debe empezar por https //console.. Por ejemplo, https //console.org-name.gdch.google.com.
* project
* Nombre del proyecto actual.
storage
* s3_access_key_id
* ID de clave de acceso del objeto de almacenamiento de S3. Es un identificador único de 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 segmento de almacenamiento de S3.
* s3_secret_access_key
* Clave privada del objeto de almacenamiento de S3 que se usa para firmar solicitudes.