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 (normalmente, ~/.config/gdcloud en macOS y Linux).
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 leer sobre las configuraciones desde la línea de comandos, así como 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 te ofrece una única configuración llamada default. Para definir propiedades en tu configuración, ejecuta el comando gdcloud
init o gdcloud config set.
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 de default no tiene nada de especial, se crea por comodidad. 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 gdcloud config configurations create:
gdcloud config configurations create NAME
Debes activar la nueva configuración después de crearla para poder usarla.
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:
gdcloud config configurations activate NAME
gdcloud config list siempre muestra las propiedades de la configuración activa.
Para cambiar la configuración activa de una sola invocación de comando, puedes usar la marca --configuration en 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:
insecure_skip_tls_verify: "false"
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.