Configurar atributos de arranque de Envoy

Cuando se inicializan los proxies de Envoy y las bibliotecas de gRPC que impulsan tu malla de servicios, deben conectarse a Cloud Service Mesh y convertirse en clientes de Cloud Service Mesh. Para establecer esta conexión, un cliente debe inicializarse con información de configuración, como la siguiente:

  • Dónde encontrar Cloud Service Mesh (trafficdirector.googleapis.com)
  • Nombre de la red VPC para la que el cliente debe solicitar la configuración
  • Otra información opcional, como si se debe habilitar el registro

En este documento se explica cómo proporcionar información de bootstrapping al usar Envoy con Cloud Service Mesh. El método que uses para proporcionar la configuración de bootstrapping varía en función de cómo implementes tus servicios:

  • Para ver las opciones de los proxies adicionales de Envoy que se despliegan automáticamente con las VMs, consulta Opciones de configuración de VMs con despliegue automático de Envoy para ver los parámetros equivalentes al crear una plantilla de instancia.
  • En el caso de los proxies sidecar de Envoy que se despliegan automáticamente con los pods de GKE, añade los parámetros admitidos que se indican a continuación al proxyMetadata del ConfigMap del inyector sidecar. Para obtener más información sobre cómo configurar los atributos obligatorios, consulta Configurar pods de Google Kubernetes Engine con inserción automática de Envoy.
  • En las implementaciones manuales de Envoy, añade los parámetros admitidos que se indican a continuación a la configuración de metadatos del nodo de arranque de tu proxy.

Solo se admite xDS v3. Si usas xDS v2, migra a xDS v3 siguiendo las instrucciones del artículo Migrar de xDS v2 a xDS v3.

Configuración de arranque necesaria para las implementaciones manuales de Envoy

La siguiente tabla contiene todos los atributos de configuración de arranque obligatorios.

Atributo Valor Descripción
TRAFFICDIRECTOR_NETWORK_NAME Se trata de una cadena. Por ejemplo: default.

Google Cloud Nombre de la red de VPC para la que se solicita la configuración (es el nombre de la red de VPC al que se hace referencia en la regla de reenvío de la API Google Cloud ). Con la API xDS v3, debes proporcionar el nombre de la red.

No se recomienda dejar este campo vacío. No se garantiza que se admita un valor vacío en futuras versiones.

TRAFFICDIRECTOR_GCP_PROJECT_NUMBER Una cadena de dígitos. Por ejemplo, 123456789. El Google Cloud proyecto en el que se configuran los recursos de Cloud Service Mesh. Es el identificador numérico de tu proyecto (por ejemplo, 111222333444).

Puedes obtener una lista de todos tus proyectos con sus números correspondientes mediante el comando gcloud projects list o consultando la sección Información del proyecto de la Google Cloud consola. Con la API xDS v3, debes proporcionar el número de proyecto.

Configuración de arranque opcional para implementaciones manuales de Envoy

La siguiente tabla contiene todos los atributos de configuración de arranque opcionales.

Atributo Valor Descripción
TRAFFICDIRECTOR_INTERCEPTION_PORT Un número entero entre 0 y 65535

Número de puerto del receptor de intercepciones. El tráfico destinado a los servicios configurados en Cloud Service Mesh debe redirigirse a este puerto.

Si este valor se deja vacío, Cloud Service Mesh no configurará el receptor de intercepciones. Si tu configuración depende de la intercepción del tráfico saliente, la ausencia del receptor de intercepción interrumpe el flujo del tráfico. Este campo no es obligatorio en los casos prácticos de proxy intermedio en los que solo se debe interceptar el tráfico entrante.

TRAFFICDIRECTOR_ACCESS_LOG_PATH Ruta al archivo de registro de acceso, representada como una cadena. Por ejemplo: "/var/log/sidecar/access.log" El valor de este parámetro se usa para configurar el registro de acceso a archivos, que Cloud Service Mesh envía a un proxy junto con otros parámetros. Todas las solicitudes entrantes y salientes se registran en este archivo. Para obtener más información, consulta la documentación sobre el registro de acceso a archivos del proxy de Envoy.
TRAFFICDIRECTOR_ENABLE_TRACING Booleano representado como una cadena. Por ejemplo, true. Habilita el proxy sidecar para generar información de análisis de trazas distribuidas. Si se define como true, Cloud Service Mesh programa los parámetros de seguimiento de Envoy en el proxy sidecar y generate_request_id se define como "true".

A continuación, se muestra un ejemplo en formato YAML de cómo configurar los atributos admitidos en la sección de metadatos de nodo de la configuración de arranque del proxy de Envoy:

node:
  metadata:
    TRAFFICDIRECTOR_INTERCEPTION_PORT: "15001"
    TRAFFICDIRECTOR_NETWORK_NAME: "default"
    TRAFFICDIRECTOR_GCP_PROJECT_NUMBER: "111222333444"
    TRAFFICDIRECTOR_ACCESS_LOG_PATH: "/tmp/sidecar/access.log"
    TRAFFICDIRECTOR_ENABLE_TRACING: "true"