Configure os atributos de arranque do Envoy

Quando os proxies do Envoy e as bibliotecas gRPC que alimentam a sua malha de serviços são inicializados, têm de se ligar à Cloud Service Mesh e tornarem-se clientes da Cloud Service Mesh. Para estabelecer esta ligação, um cliente tem de ser inicializado com informações de configuração, por exemplo:

  • Onde encontrar o Cloud Service Mesh (trafficdirector.googleapis.com)
  • O nome da rede VPC para a qual o cliente deve pedir a configuração
  • Outras informações opcionais, como se deve ativar o registo

Este documento aborda como fornecer informações de arranque quando usar o Envoy com a malha de serviços na nuvem. O método que usa para fornecer a configuração de arranque varia consoante a forma como implementa os seus serviços:

Apenas é suportado o xDS v3. Se estiver a usar o xDS v2, migre para o xDS v3 seguindo as instruções em Migre do xDS v2 para o xDS v3.

Configuração de arranque necessária para implementações manuais do Envoy

A tabela seguinte contém todos os atributos de configuração de arranque necessários.

Atributo Valor Descrição
TRAFFICDIRECTOR_NETWORK_NAME Uma string. Por exemplo: default.

Google Cloud Nome da rede VPC para a qual a configuração é pedida (este é o nome da rede VPC referenciado na regra de encaminhamento na Google Cloud API). Com a API xDS v3, tem de indicar o nome da rede.

Não recomendamos que deixe este campo com um valor vazio. Não é garantido que um valor vazio seja suportado em lançamentos futuros.

TRAFFICDIRECTOR_GCP_PROJECT_NUMBER Uma string de dígitos. Por exemplo, 123456789. O Google Cloud projeto onde os recursos da malha de serviço na nuvem estão configurados. Este é o identificador numérico do seu projeto (por exemplo, 111222333444).

Pode obter uma lista de todos os seus projetos com os respetivos números de projeto através do comando gcloud projects list ou consultando a secção Informações do projeto da Google Cloud consola. Com a API xDS v3, tem de indicar o número do projeto.

Configuração de arranque opcional para implementações manuais do Envoy

A tabela seguinte contém todos os atributos de configuração de arranque opcionais.

Atributo Valor Descrição
TRAFFICDIRECTOR_INTERCEPTION_PORT Um número inteiro no intervalo 0-65535

Um número de porta para o ouvinte de interceção. O tráfego destinado a serviços configurados na malha de serviços na nuvem tem de ser redirecionado para esta porta.

Se este valor for deixado em branco, o ouvinte de interceção não é configurado pela Cloud Service Mesh. Se a sua configuração depender da interceção de tráfego de saída, a ausência do ouvinte de interceção interrompe o fluxo de tráfego. Este campo não é obrigatório para exemplos de utilização de proxy intermédio em que apenas o tráfego de entrada tem de ser intercetado.

TRAFFICDIRECTOR_ACCESS_LOG_PATH Um caminho para o ficheiro de registo de acesso, representado como uma string. Por exemplo: "/var/log/sidecar/access.log" O valor deste parâmetro é usado para a configuração do registo de acesso a ficheiros, enviado para um proxy pelo Cloud Service Mesh com outros parâmetros. Todos os pedidos recebidos e enviados são registados neste ficheiro. Para mais informações, consulte a documentação do registo de acesso a ficheiros do proxy Envoy.
TRAFFICDIRECTOR_ENABLE_TRACING Booleano, representado como uma string; por exemplo, true Permite que o proxy sidecar gere informações de rastreio distribuído. Se estiver definido como true, os parâmetros de rastreio do Envoy são programados no proxy sidecar pelo Cloud Service Mesh e generate_request_id definido como "true".

Segue-se um exemplo no formato YAML de como configurar os atributos suportados na secção de metadados do nó da configuração de arranque do proxy 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"