Una configuración es un conjunto determinado de propiedades de la CLI de Distributed Cloud. Estas propiedades son pares clave-valor, organizados en secciones, que determinan el comportamiento de la CLI de gcloud.
Las propiedades que se almacenan normalmente 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.
Las configuraciones se almacenan en el directorio de configuración de usuario (por lo general, ~/.config/gdcloud en macOS y Linux).
Si tienes varias configuraciones, puedes optar por alternar entre ellas o ejecutar comandos con una configuración específica con la marca --configuration. Para obtener más información sobre el cambio de configuraciones, consulta la sección sobre cómo activar una configuración.
Para leer sobre las configuraciones desde la línea de comandos junto con 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 gcloud comienza con una sola configuración llamada default. Para establecer propiedades en tu configuración, ejecuta el comando gdcloud
init o gdcloud config set.
Múltiples configuraciones
La única configuración default es adecuada para la mayoría de los casos prácticos. Sin embargo, también puedes crear configuraciones adicionales y alternar entre ellas según sea necesario con gdcloud config configurations activate. No hay nada especial acerca de la configuración default inicial; se crea para tu conveniencia. Puedes nombrar esta y cualquier configuración adicional como prefieras.
Contar con múltiples configuraciones es útil si quieres hacer lo siguiente:
- Usar varios proyectos: Puedes crear una configuración distinta para cada proyecto y alternar entre ellas según sea necesario.
- Usa varias URLs de la consola de la organización.
- Realizar tareas independientes en general: Por ejemplo, puedes usar una configuración para trabajar en el servicio A en un proyecto y administrar un servicio B no relacionado en otro proyecto.
Cree una configuración
Para crear una configuración, ejecuta gdcloud config configurations create:
gdcloud config configurations create NAME
Después de crear la configuración nueva, debes activarla para poder usarla.
Cómo activar una configuración
Solo una de tus configuraciones puede estar activa en un momento determinado. La configuración activa es la configuración cuyas propiedades determinan el comportamiento de la CLI de gcloud.
Para activar una configuración o cambiar a una configuración activa nueva, ejecuta gdcloud config configurations activate:
gdcloud config configurations activate NAME
gdcloud config list siempre te muestra las propiedades en tu configuración activa.
Para cambiar la configuración activa para una sola invocación de comando, puedes usar la marca --configuration en cualquier comando de la CLI de gcloud:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Enumera las configuraciones
Para enumerar las configuraciones en tu CLI de gcloud, ejecuta el siguiente comando:
gdcloud config configurations list
La CLI de gcloud enumera las configuraciones y muestra qué configuración 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
Establece las propiedades de configuración
Para configurar o cambiar las propiedades en la configuración activa, ejecuta lo siguiente:
gdcloud config set project PROJECT
Consulta 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 gcloud 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 en la configuración activa, ejecuta el siguiente comando:
gdcloud config list
Borra una configuración
Para borrar una configuración, ejecuta el siguiente comando:
gdcloud config configurations delete NAME
No puedes borrar una configuración activa. Para cambiar a otra configuración antes de borrarla, usa gdcloud config configurations activate si es necesario.