Cómo administrar propiedades de gcloud CLI

Las propiedades son parámetros de configuración que determinan el comportamiento de gcloud CLI.

Puedes usar propiedades para definir una configuración por producto o por servicio, como la cuenta que usa gcloud CLI para la autorización, la región predeterminada que se usará cuando se trabaje con recursos de Compute Engine o la opción para desactivar las verificaciones automáticas de actualización de componentes de la gcloud CLI. Las propiedades también se pueden usar para definir las preferencias de gcloud CLI, como el nivel de verbosidad y la configuración de los mensajes de los comandos de gcloud CLI.

Propiedades y marcas

Gcloud CLI admite algunas marcas globales y marcas de comando que tienen el mismo efecto que las propiedades de gcloud CLI. 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 gcloud CLI. Gcloud CLI usa una configuración denominada default como la configuración activa inicial. La configuración de 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 configurar una propiedad en la configuración activa, ejecuta gcloud config set. En el siguiente ejemplo, se configura la propiedad project, en la que PROJECT_ID es el ID único de tu proyecto.

gcloud config set project PROJECT_ID

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. En el siguiente ejemplo, se establece el nombre de la zona en 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?