Configura gli attributi di bootstrap di Envoy

Quando i proxy Envoy e le librerie gRPC che alimentano il tuo mesh di servizi vengono inizializzati, devono connettersi a Cloud Service Mesh e diventare client di Cloud Service Mesh. Per stabilire questa connessione, è necessario eseguire l'inizializzazione di un client con informazioni di configurazione, ad esempio:

  • Dove trovare Cloud Service Mesh (trafficdirector.googleapis.com)
  • Il nome della rete VPC per cui il client deve richiedere la configurazione
  • Altre informazioni facoltative, ad esempio se attivare il logging

Questo documento spiega come fornire informazioni di bootstrap quando utilizzi Envoy con Cloud Service Mesh. Il metodo utilizzato per fornire la configurazione di bootstrap varia a seconda di come esegui il deployment dei servizi:

  • Per i proxy sidecar Envoy di cui è stato eseguito il deployment automatico con le VM, consulta Opzioni per la configurazione delle VM con deployment di Envoy automatico per gli equivalenti dei parametri quando crei un modello di istanza.
  • Per i proxy sidecar Envoy di cui è stato eseguito il deployment automaticamente con i pod GKE, aggiungi i parametri supportati riportati di seguito a proxyMetadata nel ConfigMap dell'iniettore sidecar. Per ulteriori informazioni sulla configurazione degli attributi obbligatori, consulta Configurare i pod di Google Kubernetes Engine con inserimento Envoy automatico.
  • Per i deployment manuali di Envoy, aggiungi i parametri supportati riportati di seguito alla configurazione dei metadati del nodo di bootstrap del proxy.

È supportata solo la versione 3 di xDS. Se utilizzi xDS 2, esegui la migrazione a xDS 3 seguendo le istruzioni riportate in Eseguire la migrazione da xDS 2 a xDS 3.

Configurazione di bootstrap richiesta per i deployment manuali di Envoy

La tabella seguente contiene tutti gli attributi di configurazione di bootstrap obbligatori.

Attributo Valore Descrizione
TRAFFICDIRECTOR_NETWORK_NAME Una stringa. Ad esempio: predefinito.

Il nome della rete VPC di Google Cloud per la quale è richiesta la configurazione (si tratta del nome della rete VPC a cui fa riferimento la regola di forwarding nell'API Google Cloud). Con l'API xDS v3, devi fornire il nome della rete.

Non è consigliabile lasciare questo valore vuoto. Non è garantito che un valore vuoto sia supportato nelle release future.

TRAFFICDIRECTOR_GCP_PROJECT_NUMBER Una stringa di cifre. Ad esempio, 123456789. Il progetto Google Cloud in cui sono configurate le risorse Cloud Service Mesh. Si tratta dell'identificatore numerico del progetto (ad esempio 111222333444).

Puoi ottenere un elenco di tutti i tuoi progetti con i relativi numeri utilizzando il comando gcloud projects list o consultando la sezione Informazioni sul progetto della console Google Cloud. Con l'API xDS v3, devi fornire il numero del progetto.

Configurazione di bootstrap facoltativa per i deployment manuali di Envoy

La tabella seguente contiene tutti gli attributi di configurazione di bootstrap facoltativi.

Attributo Valore Descrizione
TRAFFICDIRECTOR_INTERCEPTION_PORT Un numero intero compreso tra 0 e 65535

Un numero di porta per l'ascoltatore di intercettazione. Il traffico destinato ai servizi configurati in Cloud Service Mesh deve essere reindirizzato a questa porta.

Se questo valore viene lasciato vuoto, l'intercettatore di eventi non viene configurato da Cloud Service Mesh. Se la configurazione dipende dall'intercettazione del traffico in uscita, l'assenza dell'intercettatore interrompe il flusso di traffico. Questo campo non è obbligatorio per i casi d'uso di proxy intermedi in cui deve essere intercettato solo il traffico in entrata.

TRAFFICDIRECTOR_ACCESS_LOG_PATH Un percorso al file del log di accesso, rappresentato come stringa. Ad esempio: "/var/log/sidecar/access.log" Il valore di questo parametro viene utilizzato per la configurazione dei log di accesso ai file, inviati a un proxy da Cloud Service Mesh con altri parametri. Tutte le richieste in entrata e in uscita vengono registrate in questo file. Per ulteriori informazioni, consulta la documentazione del log di accesso ai file del proxy Envoy.
TRAFFICDIRECTOR_ENABLE_TRACING Booleano, rappresentato come stringa; ad esempio, true Consente al proxy sidecar di generare informazioni sul monitoraggio distribuito. Se impostato su true, i parametri di monitoraggio di Envoy vengono programmati nel proxy sidecar da Cloud Service Mesh e generate_request_id impostato su "true".

Di seguito è riportato un esempio in formato yaml di come configurare gli attributi supportati nella sezione dei metadati del nodo della configurazione di bootstrap del 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"