API del piano di controllo xDS

Cloud Service Mesh e i relativi client (proxy Envoy o gRPC senza proxy librerie) utilizzano lo strumento xDS open source API per scambiare informazioni. Quando configuri Cloud Service Mesh, ad esempio utilizzando risorse come regole di forwarding e servizi di backend: Cloud Service Mesh converte a una configurazione xDS che condivide con i suoi client.

Supporto della versione di xDS

Cloud Service Mesh supporta solo xDS v3.

Per determinare quali versioni di Envoy e gRPC supportano xDS v3, consulta la Envoy e documentazione di gRPC.

Se utilizzi ancora xDS v2, segui le istruzioni riportate di seguito per eseguire la migrazione xDS v3.

Migrazione da xDS v2 a xDS v3

Il processo di migrazione prevede due passaggi:

  1. Aggiornare le autorizzazioni di Identity and Access Management (IAM) concesse al servizio utilizzato dai tuoi client (proxy Envoy o librerie gRPC senza proxy) quando ti connetti a Cloud Service Mesh.
  2. Aggiornare ed eseguire nuovamente il deployment delle applicazioni. I passaggi specifici variano a seconda del deployment e sono spiegati nelle sezioni seguenti.

Aggiorna le autorizzazioni IAM dell'account di servizio

Assicurati che l'account di servizio utilizzato da Cloud Service Mesh (Envoy, gRPC senza proxy) ha lo trafficdirector.networks.reportMetrics e trafficdirector.networks.getConfigs autorizzazioni. Queste autorizzazioni sono incluse nella configurazione IAM Ruolo Client Cloud Service Mesh (roles/trafficdirector.client).

Se utilizzi un ruolo IAM personalizzato, puoi aggiungere queste autorizzazioni al ruolo personalizzato. Dopo aver aggiunto le autorizzazioni, puoi rimuovere l'account Compute Ruolo Visualizzatore rete (roles/compute.networkViewer), Amministratore rete Compute (roles/compute.networkAdmin) o entrambi dall'account di servizio.

Ti consigliamo di utilizzare il ruolo Client Cloud Service Mesh anziché il ruolo Visualizzatore di rete Compute (roles/compute.networkViewer) o Ruolo Amministratore di rete (roles/compute.networkAdmin). L'utilizzo del Il ruolo Client Cloud Service Mesh limita le autorizzazioni concesse ai l'account di servizio ed evita la concessione di autorizzazioni eccessivamente ampie.

Aggiorna le tue applicazioni

Dopo aver aggiornato le autorizzazioni IAM nell'account di servizio, aggiornare le applicazioni.

Envoy su Compute Engine

Per aggiornare le tue applicazioni su Envoy con Compute Engine, esegui una riavvio in sequenza o sostituzione dei gruppi di istanze gestite. È disponibile una versione di Envoy che supporta xDS v3 aggiunte automaticamente alle istanze di macchine virtuali (VM).

Envoy su GKE

Se utilizzi l'inserimento automatico di Envoy con Google Kubernetes Engine (GKE), reinstalla l'iniettore del sidecar sui cluster GKE che stai utilizzando Cloud Service Mesh. Quando viene creato un nuovo pod, viene generato un proxy sidecar Envoy che supporta xDS v3 viene inserito automaticamente insieme al pod del carico di lavoro.

Se utilizzi l'inserimento manuale di file collaterali su GKE, esegui nuovamente il deployment del proxy sidecar su ciascuno dei tuoi cluster GKE.

gRPC senza proxy

Il processo di migrazione prevede due passaggi:

  1. Assicurati che la versione di gRPC che utilizzi supporti xDS v3. Per ulteriori informazioni informazioni, consulta le funzionalità di xDS in gRPC.

  2. Aggiorna la configurazione del bootstrap seguendo questa procedura:

    1. Nel campo "xds_servers", aggiungi "server_features": ["xds_v3"] come mostrato in questo esempio di file di bootstrap.
    2. L'ID nodo deve essere nel seguente formato come mostrato nella precedente esempio:
      "projects/PROJECT_NUMBER/networks/NETWORK_NAME/nodes/ID"

Dopo aver apportato le modifiche precedenti all'applicazione, creala ed eseguine nuovamente il deployment.

Le modifiche precedenti alla configurazione del bootstrap non influiscono sulle versioni di gRPC che non supportano xDS v3. Inoltre, se le modifiche precedenti non sono presenti in la configurazione del bootstrap, quindi le versioni gRPC che supportano xDS v3 usano xDS v2.

Per praticità, puoi utilizzare il generatore di bootstrap gRPC di Cloud Service Mesh versione 0.11.0 per generare una configurazione bootstrap compatibile con xDS v3.

Verifica che i client Cloud Service Mesh utilizzino xDS v3

ispezionare la configurazione che Cloud Service Mesh genera per la sua puoi utilizzare strumento per lo stato del cliente. Questo strumento indica se la configurazione è xDS v2 o xDS v3.

Passaggi successivi