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 default
configuració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
- Consulta las configuraciones de la CLI de gcloud para obtener más información sobre las configuraciones.