Administrar las propiedades de la CLI de gcloud

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

Puede usar las propiedades para 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 usará al trabajar con recursos de Compute Engine o la opción para desactivar las comprobaciones automáticas de actualización de componentes de la CLI de gcloud. También puede usar las propiedades para definir las preferencias de la CLI de gcloud, como el nivel de detalle y la configuración de solicitudes para los comandos de la CLI de gcloud.

Propiedades y banderas

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

Configuraciones

Una configuración es un conjunto de propiedades de la CLI de gcloud. La CLI de gcloud utiliza una configuración default como configuración activa inicial. Esta default es adecuada para la mayoría de los casos de uso. Sin embargo, también puede crear configuraciones adicionales y alternar entre ellas según sea necesario.

Listado de propiedades

Para enumerar las propiedades en la configuración activa, ejecute gcloud config list :

gcloud config list

La CLI de gcloud devuelve 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

Propiedades de configuración

Para establecer una propiedad en la configuración activa, ejecute gcloud config set . El siguiente ejemplo establece la propiedad project , donde PROJECT_ID es el ID único del proyecto.

gcloud config set project PROJECT_ID

Para configurar propiedades que no se encuentran en la sección de propiedades core , debe 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

Configuración de propiedades mediante variables de entorno

También puede configurar propiedades mediante variables de entorno. Cada propiedad tiene una variable de entorno correspondiente que permite configurarla. El nombre de la variable de entorno sigue el patrón CLOUDSDK_SECTION_NAME_PROPERTY_NAME . Por ejemplo, puede configurar las propiedades core/project y compute/zone de la siguiente manera:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Desactivación de propiedades

Para anular la configuración de una propiedad, utilice gcloud config unset :

gcloud config unset disable_usage_reporting

Propiedades disponibles

La lista de todas las propiedades se puede encontrar ejecutando gcloud topic configurations o gcloud config set --help y buscando la sección Propiedades disponibles.

¿Qué sigue?