gdcloud topic configurations

NOMBRE

gdcloud topic configurations: ayuda complementaria para las 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. Las propiedades que se suelen almacenar 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 que, por lo general, son 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

Las configuraciones con nombre pueden definirlas los usuarios o integrarse en la CLI 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 lo siguiente:

gdcloud init

Te guiará para configurar tu primera configuración con nombre, crear una nueva o reiniciar una que ya tengas. Ten en cuenta que, al reiniciar una configuración, se eliminan todas sus propiedades.

Para crear una configuración vacía, ejecuta lo siguiente:

gdcloud config configurations create [CONFIG_NAME]

Usar configuraciones

La CLI 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

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 mostrar, 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 con 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 busca actualizaciones automáticamente.

core * disable_prompts * Si es True, se asume la respuesta predeterminada para todas las peticiones de usuario. Sin embargo, se producirá un error en las peticiones que requieran que el usuario introduzca datos. * format * Define el formato para imprimir los recursos de resultado de comando. El valor predeterminado es un formato de salida específico del comando que resulta fácil de entender. Si se especifican core/format y --format, --format tiene prioridad. Los formatos admitidos se limitan a csv, json, table, text y yaml. * organization_console_url * URL de la interfaz de usuario o de 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 se compone de S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME. S3_ENDPOINT es la ubicación donde se encuentra el segmento de almacenamiento de S3. * s3_region * El nombre de la región de S3 donde 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.