Administra las propiedades de gcloud CLI

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

Puedes usar las propiedades para definir una configuración por producto o por servicio, como la cuenta que usa gcloud CLI para la autorización, la configuración región usar cuando se trabaja con recursos de Compute Engine, o la opción de Desactiva las verificaciones automáticas de actualizaciones de componentes de gcloud CLI. Propiedades también se puede usar para definir las preferencias de gcloud CLI, como la verbosidad y la configuración de mensajes para 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 gcloud CLI. Gcloud CLI usa un de configuración llamada 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 establecer una propiedad en la configuración activa, ejecuta gcloud config set En el siguiente ejemplo, Configura el objeto project. en la que PROJECT_ID es el ID único de tu proyecto.

gcloud config set project PROJECT_ID

Para configurar propiedades que no están en core de propiedades, 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 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?