Administra propiedades del SDK

¿Qué es una propiedad?

Las propiedades son ajustes que afectan el comportamiento de la CLI de gcloud y de otras herramientas del SDK.

Las propiedades se pueden usar con el fin de definir una configuración por producto o servicio, como la cuenta usada por la CLI de gcloud y otras herramientas del SDK de Cloud para autorización, la región predeterminada que se usará cuando se trabaja con recursos de Google Compute Engine o incluso la opción para desactivar las actualizaciones automáticas del componente del SDK de Cloud. Las propiedades también se pueden usar para definir las preferencias de la herramienta de línea de comandos de gcloud, como el nivel de verbosidad y la configuración del mensaje de los comandos de la CLI de gcloud.

Propiedades y marcas

La CLI de gcloud admite algunas marcas globales y marcas de comando que tienen el mismo efecto que las propiedades del SDK. Por ejemplo, la CLI de gcloud admite la marca --project y la propiedad project. Las propiedades te permiten mantener la misma configuración en todas las ejecuciones de comandos, mientras que las marcas afectan el comportamiento de los comandos por invocación. Ten en cuenta que las marcas anulan las propiedades cuando ambas están configuradas.

Configuraciones

Una configuración es un conjunto determinado de propiedades del SDK. La CLI de gcloud usa una configuración denominada default como la configuración activa inicial. 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.

Haz una lista de las propiedades

Para ver una lista de las propiedades en la configuración activa, ejecuta gcloud config list:

gcloud config list

La CLI de gcloud muestra la lista de propiedades:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Configura propiedades

Para configurar una propiedad en la configuración activa, ejecuta gcloud config set:

gcloud config set project [PROJECT]

Para configurar propiedades que no se encuentran en la sección de propiedades core, debes especificar la sección seguida de una barra diagonal antes del nombre de la propiedad:

gcloud config set compute/zone us-east1-b

Configura propiedades a través de variables de entorno

También puedes establecer propiedades a través de variables de entorno. Cada propiedad tiene una variable de entorno correspondiente que se puede usar para configurarla. El nombre de la variable de entorno sigue el patrón CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Por ejemplo, puedes configurar las propiedades core/project y compute/zone de la siguiente manera:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]
CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Desconfigura propiedades

Para desactivar una propiedad en la configuración activa, usa gcloud config unset:

gcloud config unset disable_usage_reporting

Propiedades disponibles

Puedes encontrar la lista de todas las propiedades si ejecutas gcloud topic configurations o gcloud config set --help y buscas la sección de Propiedades disponibles.

Qué sigue