Administra las propiedades del SDK de Cloud

Las propiedades son configuraciones que rigen el comportamiento de la herramienta de línea de comandos de gcloud y de otras herramientas del SDK de Cloud.

Puedes usar propiedades para definir una configuración por producto o por servicio, como la cuenta que usa lagcloud la herramienta y otras herramientas del SDK de Cloud para la autorización, la región predeterminada que se usará cuando se trabaje con recursos de Compute Engine o la opción de desactivar las actualizaciones automáticas del componente del SDK de Cloud. Las propiedades también se pueden usar con el fin de definir las preferencias de la herramienta de gcloud, como el nivel de verbosidad y la configuración de mensajes para los comandos de la herramienta de gcloud.

Propiedades y marcas

La herramienta de gcloud admite algunas marcas globales y marcas de comando que tienen el mismo efecto que las propiedades del SDK de Cloud. Por ejemplo, la herramienta 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 de Cloud. La herramienta de gcloud usa una configuración llamada default como la configuración activa inicial. default es adecuado 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 herramienta 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 con variables de entorno

También puedes establecer propiedades mediante 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?