Una configuración es un conjunto de propiedades de la CLI de Distributed Cloud con nombre. Estas propiedades son pares clave-valor, organizados en secciones, que rigen el comportamiento de la CLI de gdcloud.
Entre las propiedades que se suelen almacenar 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.
Las configuraciones se almacenan en el directorio de configuración de usuario, que suele ser ~/.config/gdcloud en macOS y Linux. Ten en cuenta también que el directorio de configuración debe tener habilitado el permiso de escritura.
Si tienes varias configuraciones, puedes cambiar de una a otra o ejecutar comandos con una configuración específica mediante la marca --configuration. Para obtener más información sobre cómo cambiar de configuración, consulta la sección Activar una configuración.
Para consultar las configuraciones desde la línea de comandos y ver una lista completa de las propiedades disponibles y las secciones en las que se encuentran, ejecuta gdcloud topic
configurations.
Configuración predeterminada
La CLI de gdcloud crea inicialmente una sola configuración llamada
default. Puede definir propiedades en su configuración ejecutando el comando gdcloud
init o gdcloud config set directamente.
Varias configuraciones
La configuración default es adecuada para muchos casos prácticos. Sin embargo, también puedes crear configuraciones adicionales y cambiar de una a otra según sea necesario con gdcloud config configurations activate. La configuración inicial se crea para tu comodidad y no es obligatoria.default Puedes asignar el nombre que quieras a esta y a cualquier otra configuración.
Las configuraciones múltiples son útiles si quieres hacer lo siguiente:
- Usar varios proyectos: puedes crear una configuración independiente para cada proyecto y cambiar de uno a otro según sea necesario.
- Usar varias URLs de la consola de organización.
- Realizar tareas generalmente independientes: por ejemplo, puedes usar una configuración para trabajar en el servicio A de un proyecto y gestionar un servicio B no relacionado en otro proyecto.
Crear una configuración
Para crear una configuración, ejecuta el siguiente comando:
gdcloud config configurations create NAME
Para usar la nueva configuración, debes activarla después de crearla.
Activar una configuración
Solo puede haber una configuración activa a la vez. La configuración activa es la configuración cuyas propiedades rigen el comportamiento de la CLI de gdcloud.
Para activar una configuración nueva o cambiar a una configuración activa, ejecuta el siguiente comando:
gdcloud config configurations activate NAME
gdcloud config list siempre le mostrará las propiedades de su configuración activa.
Para cambiar la configuración activa de una sola invocación de comando, aplica la marca --configuration a cualquier comando de la CLI de gdcloud:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Mostrar configuraciones
Para enumerar las configuraciones de tu CLI de gdcloud, ejecuta el siguiente comando:
gdcloud config configurations list
La CLI de gdcloud muestra las configuraciones y cuál de ellas está activa:
NAME ISACTIVE PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default False example-project-default https://console.default-org.example.com
config-project-1 False example-project-1 https://console.org-1.example.com
config-project-2 False example-project-2 https://console.org-2.example.com
Definir propiedades de configuración
Para definir y anular las propiedades de la configuración activa, ejecuta lo siguiente:
gdcloud config set project PROJECT
Ver las propiedades de configuración
Para ver las propiedades de una configuración, ejecuta el siguiente comando:
gdcloud config configurations describe NAME
La CLI de gdcloud imprime las propiedades de configuración:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
auth:
login_config_cert_path: /tmp/root-web-tls-ca.cert
core:
organization_console_url: https://console.example.com
project: example-project
Para ver las propiedades de la configuración activa, ejecuta el siguiente comando:
gdcloud config list
Eliminar una configuración
Para eliminar una configuración, ejecuta el siguiente comando:
gdcloud config configurations delete NAME
No puedes eliminar una configuración activa. Para cambiar a otra configuración antes de eliminarla, usa gdcloud config configurations activate si es necesario.