Cómo administrar 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 configuraciones, puedes elegir alternar entre ellas o ejecutar comandos mediante una configuración específica (con ayuda de la marca --configuration). Para obtener más información sobre el cambio de configuraciones, consulta la sección a continuación sobre Cómo activar configuraciones.

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

Configuración predeterminada

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

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 configuraciones 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.

Cómo crear 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.

Para cambiar la configuración activa para una sola invocación de comando, puedes usar la marca --configuration o cualquier comando 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.

Cómo automatizar el cambio de configuración

Para ayudar a que el cambio de configuraciones sea eficiente, puedes aprovechar herramientas como direnv y ondir para cambiar automáticamente entre configuraciones 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.

Cómo hacer una lista de configuraciones

Para hacer una lista de las configuraciones en tu SDK de Cloud, ejecuta gcloud config configurations list:

gcloud config configurations list

gcloud enumera las configuraciones y muestra la configuración activa en ese momento:

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

Cómo configurar las propiedades de configuración

Para configurar y desconfigurar 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

Cómo ver las propiedades de configuración

Para ver las propiedades en 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

gcloud imprime las propiedades de la configuración:

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

Cómo borrar 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 borrar la actual.

¿Qué sigue?

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del SDK de Cloud