Administra las propiedades de la CLI de gcloud

Las propiedades son ajustes que rigen el comportamiento de la CLI de gcloud.

Puedes usar propiedades a fin de definir una configuración por producto o servicio, como la cuenta que usa la CLI de gcloud para la autorización, la región predeterminada que se debe usar cuando se trabaja con recursos de Compute Engine o la opción de desactivar las verificaciones de componentes automáticas de la CLI de gcloud. También se pueden usar las propiedades para definir las preferencias de la CLI de gcloud, como el nivel de verbosidad y la configuración de mensajes para 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 de la CLI de gcloud. 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 de la CLI de gcloud. La CLI de gcloud usa una configuración llamada default como la configuración activa inicial. La configuración default es adecuada para la mayoría de los casos de uso. 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 establecer una propiedad en la configuración activa, ejecuta gcloud config set. En el siguiente ejemplo, se configura la propiedad project, donde PROJECT_ID es el ID único para tu proyecto.

gcloud config set project PROJECT_ID

Para configurar propiedades que no están en la sección de propiedades core, debes especificar la sección seguida de una barra diagonal antes del nombre de la propiedad. En el siguiente ejemplo, se configura el nombre de la zona como us-east1-b.

gcloud config set compute/zone us-east1-b

Configura propiedades mediante 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=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=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?