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 del usuario, que suele ser ~/.config/gdcloud en macOS y Linux. Además, ten en cuenta que el directorio de configuración debe tener habilitada la escritura.
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 y obtener una lista completa de las propiedades disponibles y las secciones en las que se encuentran, ejecuta gdcloud topic
configurations.
Configuración predeterminada
Inicialmente, la CLI de gcloud crea una sola configuración llamada default. Para establecer las propiedades en tu configuración, ejecuta el comando gdcloud
init o ejecuta gdcloud config set directamente.
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. La configuración inicial de default se crea para tu conveniencia y no es obligatoria. 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 el siguiente comando:
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 lo siguiente:
gdcloud config configurations activate NAME
gdcloud config list siempre te mostrará las propiedades en tu configuración activa.
Para cambiar la configuración activa para una sola invocación de comando, aplica la marca --configuration a 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:
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.