Cómo administrar propiedades del SDK

¿Qué es una propiedad?

Las propiedades son ajustes que determinan el comportamiento de gcloud y de otras herramientas del SDK.

Las propiedades se pueden usar para definir la configuración por producto o por servicio, como la cuenta usada por gcloud y otras herramientas del SDK de Cloud para la autorización, la región predeterminada que se usará al trabajar con recursos de Google Compute Engine, o incluso la opción de desactivar las actualizaciones automáticas de los componentes del SDK de Cloud. También se pueden usar las propiedades para definir las preferencias de gcloud, como el nivel de verbosidad y la configuración de mensajes para los comandos de gcloud.

Propiedades y marcas

gcloud admite algunas marcas globales y marcas de comando que tienen el mismo efecto que las propiedades del SDK. Por ejemplo, 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 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 del SDK. gcloud usa una configuración llamada default como la configuración activa inicial; default es adecuada para la mayoría de los casos prácticos. Sin embargo, también puedes crear configuraciones adicionales y alternar entre ellas según sea necesario.

Cómo hacer una lista de las propiedades

Para hacer una lista de las propiedades en la configuración activa, ejecuta gcloud config list:

gcloud config list

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

Cómo configurar propiedades

Para configurar una propiedad en la configuración activa, ejecuta gcloud config set:

gcloud config set project [PROJECT]

Para configurar propiedades que no están en la sección de propiedades core, debes especificar la sección seguida de una barra diagonal antes del nombre de la propiedad:

gcloud config set compute/zone us-east1-b

Cómo desconfigurar propiedades

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

gcloud config unset disable_usage_reporting

Tipos de propiedad

Las propiedades del SDK están organizadas en secciones que agrupan las propiedades relacionadas por conveniencia cuando ves las listas de propiedades.

Propiedades principales

La sección core contiene las propiedades de configuración para el comando de gcloud.

Nombre Descripción
account Cuenta de usuario o servicio usada por gcloud y otras herramientas del SDK para autorización.
disable_color Si se configura en True, evita que gcloud imprima mensajes en color al terminal.
disable_prompts Si se configura en True, elimina los mensajes para todos los comandos gcloud y adopta la respuesta predeterminada. Si un comando requiere la entrada del usuario, y no se puede usar una predeterminada, gcloud informa un error. Equivalente a la marca --quiet global.
disable_usage_reporting Si se configura en True, inhabilita la colección de estadísticas anónimas en el uso del SDK. Configuras este valor cuando instalas el SDK, pero puedes modificarlo en cualquier momento.
log_http Si se configura en True, habilita la escritura de solicitudes HTTP y respuestas a registros. Si quieres ver estos mensajes en tu terminal, ajusta tu configuración de verbosidad mediante la propiedad verbosity o la marca --verbosity global.
project ID de proyecto del proyecto actual de Cloud Platform. Puedes anular este valor mediante la marca --project global.
trace_token Token proporcionado por la Atención al cliente de Google para el enrutamiento de registros de solicitudes de servicio para la investigación de problemas.
user_output_enabled Habilita la impresión del resultado del comando para resultado estándar y error estándar en la terminal. Si se configura en False, se elimina el resultado.
verbosity Registro de verbosidad para comandos de gcloud. gcloud admite los niveles de verbosidad estándar siguientes:
  • debug
  • info
  • warning
  • error
  • critical
  • none
Equivalente al uso de la marca --verbosity global.

Propiedades del administrador de componentes

La sección component_manager contiene propiedades usadas al administrar componentes del SDK.

Nombre Descripción
component_manager/additional_repositories Lista separada por comas de repositorios adicionales para buscar componentes. Esta propiedad se administra automáticamente por los comandos en el grupo de comandos gcloud components repositories.
component_manager/disable_update_check Si se configura en True, el SDK no busca automáticamente las actualizaciones.

Propiedades de App Engine

La sección app contiene propiedades que especifican el comportamiento del comando gcloud app deploy.

Nombre Descripción
app/stop_previous_version Si se configura en True, detiene la versión implementada previamente al implementar una versión nueva de la aplicación. Si se configura en False, la versión anterior debe detenerse manualmente antes de la implementación.

Propiedades de Compute Engine

La sección compute contiene propiedades usadas por los comandos de gcloud que operan en los recursos de Google Compute Engine.

Nombre Descripción
compute/region Región predeterminada que se usa cuando se trabaja con recursos de Compute Engine. Si un comando gcloud requiere la marca --region, pero no se le proporciona, se usa este valor.
compute/zone Zona predeterminada que se usa cuando se trabaja con recursos de Compute Engine. Si un comando de gcloud requiere la marca --zone, pero no se le proporciona, se usa este valor.

Propiedades de Kubernetes Engine

La sección container contiene propiedades usadas por los comandos de gcloud que operan en los clústeres de Google Kubernetes Engine.

Nombre Descripción
container/cluster Nombre del clúster predeterminado.

Propiedades del proxy de red

La sección proxy contiene propiedades relacionadas con el uso de proxies de red por el comando de gcloud.

Nombre Descripción
proxy/type Tipo de servidor proxy. Los tipos de proxy compatibles son los siguientes:
  • http
  • http_no_tunnel
  • socks4
  • socks5
proxy/address Nombre de host o dirección IP del servidor proxy.
proxy/port Puerto usado al conectarse al servidor proxy.
proxy/username Nombre de usuario usado al conectarse al servidor proxy, si es necesario.
proxy/password Contraseña usada al conectarse al servidor proxy, si es necesaria.
proxy/rdns Si se configura en True (predeterminado), las consultas de DNS no se ejecutarán localmente. En cambio, se entregarán al proxy para que las resuelva.

¿Qué sigue?

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del SDK de Cloud