NAME
gdcloud topic configurations: ayuda complementaria para configuraciones con nombre
DESCRIPCIÓN
Las propiedades de la CLI gdcloud se pueden almacenar en configuraciones con nombre, que son colecciones de pares clave-valor que influyen en el comportamiento de la CLI gdcloud.
Las configuraciones con nombre son útiles si gestionas más de un proyecto u organización.
Entre las propiedades que suelen almacenarse en las configuraciones se 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.
- Usas varias URLs de la consola de la organización.
* Realizas tareas generalmente independientes. Por ejemplo, se puede usar una configuración para trabajar en el servicio de almacenamiento de objetos de un proyecto y gestionar un servicio no relacionado en otro proyecto.
Todos los comandos de la CLI gdcloud pueden leer la información de las propiedades almacenada en las 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 gdcloud.
Las configuraciones definidas por el usuario tienen nombres en minúscula, 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
Este comando te guiará por los pasos para configurar tu primera configuración con nombre, crear una configuración con nombre o reinicializar una configuración con nombre. Ten en cuenta que, si reinicializas una configuración, se eliminarán todas sus propiedades.
Para crear una configuración vacía, ejecuta 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 afectan a las ejecuciones de la CLI gdcloud. Para activar una configuración, ejecuta el siguiente comando:
gdcloud config configurations activate [CONFIG_NAME]
Para ver y cambiar las propiedades de tu configuración activa, ejecuta el siguiente comando:
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 gdcloud no comprueba automáticamente si hay actualizaciones.
core
* disable_prompts
* Si es True, se asume la respuesta predeterminada para todas las solicitudes de usuario. Sin embargo, se genera un error en las solicitudes que requieren entrada del usuario.
* format
* Define el formato para imprimir los recursos de salida de los comandos. El valor predeterminado es un formato de salida legible para humanos específico de cada comando. Si se especifican tanto core/format como --format, tiene prioridad --format. Los formatos admitidos son csv, json, table, text y yaml.
* organization_console_url
* URL de la interfaz de usuario o 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 del 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 en la que se encuentra el segmento de almacenamiento de S3.
* s3_region
* Nombre de la región de S3 en la que se encuentra el segmento de almacenamiento de S3. El valor predeterminado es us-east-1.
* s3_secret_access_key
* Clave privada del objeto de almacenamiento de S3 que se usa para firmar solicitudes.