NAME
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.
Las configuraciones con nombre son beneficiosas si administras más de un proyecto o una 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 distinta 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 gdcloud pueden leer la información de las propiedades almacenada en las configuraciones con nombre. Para configurar las propiedades, usa el comando gdcloud config set.
Crear opciones de configuración
Los usuarios pueden definir las configuraciones con nombre o integrarlas en la CLI de gdcloud.
Las configuraciones definidas por el usuario tienen nombres en minúscula, 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
Esto te guiará para configurar tu primera configuración con nombre, crear una nueva configuración con nombre o reinicializar 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
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 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
* Es la ruta de acceso al archivo que almacena el certificado de configuración de acceso actual.
component_manager
* disable_update_check
* Si se configura, la CLI de gdcloud no busca actualizaciones automáticamente.
core
* disable_prompts
* Si es True, se supone la respuesta predeterminada para todos los mensajes del usuario. Sin embargo, para cualquier mensaje que requiera la entrada del usuario, se genera un error.
* format
* Establece el formato para imprimir recursos de resultado del comando. 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 se limitan a csv, json, table, text, yaml.
* organization_console_url
* Es la 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
* Es el nombre del proyecto actual.
storage
* s3_access_key_id
* Es el ID de la clave de acceso del objeto de almacenamiento de S3. Es un identificador único para los usuarios.
* s3_custom_ca_certs_file
* Es el 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 en la que se encuentra el bucket de almacenamiento de S3.
* s3_region
* Es el nombre de la región de S3 en la que se encuentra el bucket de almacenamiento de S3. El valor predeterminado es us-east-1.
* s3_secret_access_key
* Es la clave privada del objeto de almacenamiento de S3 que se usa para firmar solicitudes.