Administra configuraciones del SDK

¿Qué es una configuración?

Una configuración es un conjunto determinado de propiedades del SDK. Estas propiedades son pares clave-valor que determinan el comportamiento de la herramienta de línea de comandos de gcloud y de otras herramientas del SDK.

Las propiedades que son almacenadas normalmente en las configuraciones incluyen la zona predeterminada de Google Compute Engine, nivel de verbosidad, informes de uso, ID de proyecto y una cuenta de usuario o de servicio activa. Las configuraciones te permiten definir y habilitar estas y otras configuraciones, juntas como un grupo.

Si tienes varias opciones de configuración, puedes optar por alternar entre ellas o ejecutar comandos mediante una configuración específica (con la ayuda de la marca --configuration). Para obtener más información sobre el cambio de configuración, consulta la sección que aparece a continuación sobre cómo activar opciones de configuración.

Para leer sobre la configuración desde la línea de comandos (junto con una lista completa de las propiedades disponibles), ejecuta gcloud topic configurations.

Configuración predeterminada

El SDK comienza con una sola configuración llamada default. Para establecer las propiedades en tu configuración, ejecuta el comando gcloud init o ejecuta gcloud config set directamente.

Por ejemplo, para inhabilitar los mensajes para la secuencia de comandos, ejecuta lo siguiente:

gcloud config set disable_prompts true

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 opciones de configuración adicionales y alternar entre ellas según sea necesario con gcloud 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.
  • Usar varias cuentas de autorización.
  • Realizar tareas independientes en general: Por ejemplo, puedes usar una configuración para trabajar en una aplicación Google App Engine en un proyecto y administrar instancias de Compute Engine no vinculadas en otro proyecto.

Crea una configuración

Para crear una configuración, ejecuta gcloud config configurations create:

gcloud config configurations create [NAME]

Después de crear la configuración, 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 las herramientas del SDK.

Para activar una configuración o cambiar a una configuración activa nueva, ejecuta gcloud config configurations activate:

gcloud config configurations activate [NAME]

gcloud config list siempre te mostrará las propiedades en tu configuración activa.

A fin de 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:

gcloud auth list --configuration=[CONFIGURATION_NAME]

Para cambiar la configuración activa para todos los comandos en tu terminal actual, puedes establecer la variable de entorno CLOUDSDK_ACTIVE_CONFIG_NAME con el nombre de la configuración que deseas usar.

Automatiza el cambio de configuración

A fin de ayudar a que el cambio de configuración sea eficiente, puedes aprovechar herramientas como direnv y ondir para cambiar de forma automática entre opciones de configuración cuando cambias de directorios de trabajo. Una manera de lograr esto sería establecer las variables de entorno necesarias (como CLOUDSDK_ACTIVE_CONFIG_NAME), en el archivo .envrc, en el directorio raíz de tu proyecto.

Haz una lista de configuraciones

Para ver una lista de las opciones de configuración en tu instalación del SDK de Cloud, ejecuta gcloud config configurations list:

gcloud config configurations list

La CLI de gcloud enumera las opciones de configuración y muestra qué configuración está activa actualmente:

NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

Establece las propiedades de configuración

Para configurar o cambiar las propiedades en la configuración activa, ejecuta gcloud config set y gcloud config unset:

gcloud config set project [PROJECT]
gcloud config unset disable_usage_reporting

Consulta las propiedades de configuración

Para ver las propiedades de una configuración, ejecuta: gcloud config configurations describe:

gcloud config configurations describe [NAME]

O, para ver las propiedades en la configuración activa, lo siguiente:

gcloud config list

La CLI de gcloud imprime las propiedades de configuración:

is_active: false
name: default
properties:
  compute:
    region: us-east1
    zone: us-east1-b
  core:
    account: user@google.com
    project: example-project

Borra una configuración

Para borrar una configuración, ejecuta gcloud config configurations delete:

gcloud config configurations delete [NAME]

No puedes borrar la configuración activa. Usa gcloud config configurations activate si es necesario para cambiar a otra configuración antes de borrarla.

Próximos pasos