Gestionar propiedades de la CLI de gcloud

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

Puedes usar propiedades para definir un ajuste por producto o por servicio, como la cuenta que usa la CLI de gcloud para la autorización, la región predeterminada que se debe usar al trabajar con recursos de Compute Engine o la opción para desactivar las comprobaciones automáticas de actualizaciones de componentes de la CLI de gcloud. Las propiedades también se pueden usar para definir preferencias de la interfaz de línea de comandos de gcloud, como el nivel de detalle y la configuración de las peticiones de los comandos de la interfaz de línea de comandos de gcloud.

Propiedades y marcas

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

Configuraciones

Una configuración es un conjunto de propiedades de la CLI de gcloud con nombre. La CLI de gcloud usa una configuración llamada default como configuración activa inicial. La defaultconfiguración es adecuada para la mayoría de los casos prácticos. Sin embargo, también puedes crear configuraciones adicionales y cambiar de una a otra según sea necesario.

Propiedades de la ficha

Para enumerar las propiedades de la configuración activa, ejecuta el siguiente comando: 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

Definir propiedades

Para definir una propiedad en la configuración activa, ejecuta gcloud config set. En el siguiente ejemplo se define la propiedad project, donde PROJECT_ID es el ID único de tu proyecto.

gcloud config set project PROJECT_ID

Para definir propiedades que no se encuentren en la sección de propiedades core, debe especificar la sección seguida de una barra inclinada antes del nombre de la propiedad. En el siguiente ejemplo se asigna el nombre de zona us-east1-b.

gcloud config set compute/zone us-east1-b

Definir propiedades mediante variables de entorno

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

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Eliminar propiedades

Para anular una propiedad en la configuración activa, usa gcloud config unset:

gcloud config unset disable_usage_reporting

Propiedades disponibles

Para ver la lista de todas las propiedades, ejecuta gcloud topic configurations o gcloud config set --help y busca la sección Available Properties (Propiedades disponibles).

Siguientes pasos