Configura los atributos de arranque de Envoy para Traffic Director

Cuando se inicializan los proxies de Envoy y las bibliotecas de gRPC que potencian la malla de servicios, necesitan conectarse a Traffic Director y convertirse en sus clientes. Para establecer esta conexión, un cliente debe iniciarse con información de configuración, por ejemplo:

  • Dónde encontrar Traffic Director (trafficdirector.googleapis.com)
  • El nombre de la red de VPC en la que el cliente debe solicitar la configuración
  • Información adicional opcional, como si se deben habilitar los registros

En este documento, se explica cómo suministrar información de arranque cuando usas Envoy con Traffic Director. El método que uses para proporcionar la configuración de arranque varía según cómo implementes tus servicios:

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

En la siguiente tabla, se incluyen todos los atributos obligatorios de configuración de arranque.

Atributo Valor Descripción
TRAFFICDIRECTOR_NETWORK_NAME Una string. Por ejemplo: predeterminada.

Nombre de la red de VPC de Google Cloud para la que se solicita la configuración (este es el nombre de la red de VPC a la que se hace referencia en la regla de reenvío en la API de Google Cloud).

  • Cuando usas la API de xDS v2, te recomendamos que establezcas el nombre de la red. Si este valor se deja vacío, Traffic Director intenta seleccionar la configuración de la red de VPC a través de la cual se envía la solicitud del proxy de sidecar a trafficdirector.googleapis.com.
  • Cuando usas la API de xDS v3, debes proporcionar el nombre de la red.
  • No se recomienda dejar esto como un valor vacío. No se garantiza que un valor vacío sea compatible con futuras versiones.

    TRAFFICDIRECTOR_GCP_PROJECT_NUMBER Una string de dígitos. Por ejemplo, 123456789. El proyecto de Google Cloud en el que se configuran los recursos de Traffic Director. Este es el identificador numérico del proyecto (por ejemplo, 111222333444).

    Puedes obtener una lista de todos los proyectos con sus números de proyecto correspondientes mediante el comando gcloud projects list o si revisas la sección Información del proyecto de Google Cloud Console.

  • Si usas la API de xDS v2, te recomendamos que establezcas el número de proyecto. Si dejas el campo vacío, Traffic Director intentará recuperar la configuración del proyecto de GCP asociado con las credenciales de la cuenta de servicio. No se garantiza que un valor vacío sea compatible con futuras versiones.
  • Cuando usas la API de xDS v3, debes proporcionar el número de proyecto.
  • Configuración de arranque opcional para implementaciones manuales de Envoy

    En la siguiente tabla, se incluyen todos los atributos opcionales de configuración de arranque.

    Atributo Valor Descripción
    TRAFFICDIRECTOR_INTERCEPTION_PORT Un número entero en el rango de 0 a 65535.

    Un número de puerto para el objeto de escucha de la interceptación. El tráfico dirigido a los servicios configurados en Traffic Director debe redireccionarse a este puerto.

    Si este valor se deja vacío, el objeto de escucha de la intercepción no se configura mediante Traffic Director. Si la configuración depende de la intercepción del tráfico, la ausencia del objeto de escucha de la intercepción interrumpirá el flujo del tráfico. Este campo no es obligatorio para los casos de uso de proxy central en los que solo se debe interceptar el tráfico entrante.

    TRAFFICDIRECTOR_ACCESS_LOG_PATH Es la ruta de acceso al archivo de registro de acceso, representada como una string. Por ejemplo: “/var/log/sidecar/access.log”. El valor de este parámetro se usa como la configuración de registro de acceso a archivos, que Traffic Director envía a un proxy con otros parámetros. Todas las solicitudes entrantes y salientes se registran en este archivo. Para obtener más información, consulta File access log (Registro de acceso a archivos) en la documentación del proxy de Envoy.
    TRAFFICDIRECTOR_ENABLE_TRACING Booleano, representado como una string, por ejemplo, true Habilita el proxy de sidecar para generar información de seguimiento distribuida. Si se configura como true, Traffic Director programa los parámetros de seguimiento de Envoy en el proxy de sidecar y generate_request_id se establece en “verdadero”.

    El siguiente es un ejemplo en formato yaml en el que se muestra cómo configurar los atributos admitidos en la sección de metadatos de nodos 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"