Esegui la migrazione dei cluster nativi di VPC a GKE Dataplane V2

Utilizza questo documento per eseguire la migrazione dei cluster nativi di VPC Google Kubernetes Engine (GKE) esistenti da Dataplane V1 a GKE Dataplane V2, monitorare la migrazione ed eseguirne il rollback, se necessario.

Questo documento è rivolto agli amministratori e agli operatori della piattaforma e agli esperti di networking che gestiscono le configurazioni di rete per i cluster GKE.

Prima di iniziare, scopri cosa succede durante ogni fase della migrazione e come pianificare l'interruzione del workload in Informazioni sulla migrazione a GKE Dataplane V2.

Prima di iniziare

Prima di avviare la migrazione, verifica che il cluster soddisfi i requisiti di idoneità e valuta l'impatto sui tuoi workload.

Verifica che il cluster soddisfi i seguenti requisiti:

  • Il cluster è un cluster nativo di VPC.
  • Il cluster esegue la versione 1.35.3-gke.1155000 o successive.
  • I node pool eseguono la versione 1.35.1-gke.1516000 o successiva.
  • Se utilizzi Cloud Service Mesh o Istio open source, la tua versione di Istio è 1.23 o successiva.

Prepara il cluster

Completa le seguenti attività prima di iniziare la migrazione:

  • Rimozione di NetworkPolicy: rimuovi le policy di rete esistenti. Se GKE applica improvvisamente le policy di rete quando ricrea i nodi, potresti riscontrare interruzioni di rete impreviste.
  • Policy di rete Calico: se utilizzi un cluster GKE Standard con policy di rete (Calico) abilitata, disabilita l'applicazione delle policy di rete. Non puoi eseguire la migrazione di questi cluster direttamente.
  • Suggerimenti di Active Assist: controlla Active Assist o la pagina dei dettagli del cluster per verificare se sono presenti suggerimenti che potrebbero entrare in conflitto con la migrazione.
  • Capacità degli indirizzi IP: verifica che l'intervallo di indirizzi IP dei pod del cluster abbia una capacità sufficiente per le strategie di upgrade dei pool di nodi. Per saperne di più, consulta Insight sull'utilizzo degli indirizzi IP di GKE.
  • Funzionalità di networking: attiva funzionalità di networking come NodeLocal DNSCache o la visibilità tra nodi prima di iniziare la migrazione o dopo averla completata. Non puoi attivarli durante la migrazione.

Comprendi le limitazioni

  • Configurazioni di rete bloccate: dopo aver avviato la migrazione, non puoi modificare le configurazioni di rete a livello di cluster fino al completamento della migrazione.
  • Periodi di manutenzione: la migrazione segue i periodi di manutenzione e le esclusioni dalla manutenzione, quindi potrebbe sembrare bloccata. Per accelerare l'operazione, puoi applicare manualmente le patch ai node pool. Per la procedura, vedi Velocizza la migrazione.
  • Funzionalità GKE Dataplane V2 facoltative: configura le funzionalità GKE Dataplane V2 facoltative, come l'osservabilità di GKE Dataplane V2 o il supporto di più reti per i pod, dopo il completamento della migrazione.
  • Terraform: non puoi utilizzare Terraform per eseguire la migrazione a GKE Dataplane V2.

Avvia la migrazione

Per avviare manualmente la migrazione e bypassare i controlli diagnostici automatici, puoi applicare una patch al cluster utilizzando Google Cloud CLI.

Esegui questo comando:

gcloud container clusters update CLUSTER_NAME \
    --location=LOCATION \
    --enable-dataplane-v2

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del cluster.
  • LOCATION: la località di computing del cluster.

Osserva l'avanzamento della migrazione

Puoi monitorare lo stato della migrazione controllando il campo datapathProvider. Durante la transizione, questo campo mostra MIGRATE_TO_ADVANCED_DATAPATH.

  1. Controlla lo stato del cluster:

    gcloud container clusters describe CLUSTER_NAME \
        --location=LOCATION \
        --format='value(networkConfig.datapathProvider)'
    

    Sostituisci quanto segue:

    • CLUSTER_NAME: il nome del cluster.
    • LOCATION: la località di computing del cluster.
  2. Controlla lo stato del pool di nodi:

    gcloud container node-pools list \
        --cluster=CLUSTER_NAME \
        --location=LOCATION \
        --format='value(name, networkConfig.datapathProvider)'
    

    Sostituisci quanto segue:

    • CLUSTER_NAME: il nome del cluster.
    • LOCATION: la località di computing del cluster.
  3. Controlla il DaemonSet anetd per verificare che gli agenti siano in esecuzione:

    kubectl get ds -n kube-system anetd
    

Accelerare la migrazione

Per bypassare la pianificazione dell'implementazione automatica, puoi applicare manualmente le patch ai node pool.

Per applicare manualmente una patch a un pool di nodi, esegui questo comando:

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --location=LOCATION \
    --datapath-provider=advanced-datapath

Sostituisci quanto segue:

  • NODE_POOL_NAME: il nome del pool di nodi.
  • CLUSTER_NAME: il nome del cluster.
  • LOCATION: la località di computing del cluster.

Finalizza la migrazione

Dopo aver eseguito la migrazione di tutti i node pool a GKE Dataplane V2, GKE finalizza automaticamente la migrazione. Al termine della migrazione, l'output comando mostra lo stato ADVANCED_DATAPATH e il cluster esegue GKE Dataplane V2.

Osserva il completamento controllando lo stato del cluster:

gcloud container clusters describe CLUSTER_NAME \
    --location=LOCATION \
    --format='value(networkConfig.datapathProvider)'

Sostituisci quanto segue:

  • CLUSTER_NAME: il nome del cluster.
  • LOCATION: la località di computing del cluster.

Al termine della migrazione, l'output mostra ADVANCED_DATAPATH.

Esegui il rollback di una migrazione

Puoi ripristinare la migrazione a Dataplane V1 in qualsiasi momento prima del completamento della fase di finalizzazione. L'inversione della migrazione è un processo simmetrico rispetto alla migrazione in avanti: dopo l'avvio del rollback, GKE applica automaticamente le patch ai node pool per tornare al percorso dati legacy e poi finalizza il cluster.

  1. Osserva l'integrità di anetd: prima di eseguire il rollback della migrazione, controlla se gli agenti sono in esecuzione per determinare se l'errore può essere mitigato.

    kubectl get ds -n kube-system anetd
    
  2. Annulla le operazioni in pool di nodi pool:

    1. Identifica e annulla le operazioni in esecuzione sul pool di nodi che bloccherebbero la richiesta di patch del cluster.

      gcloud container operations list \
          --location=LOCATION \
          --filter="operationType=UPGRADE_NODES AND status=RUNNING AND targetLink:*/clusters/CLUSTER_NAME"
      

      Sostituisci quanto segue:

      • LOCATION: la località di computing del cluster.
      • CLUSTER_NAME: il nome del cluster.
    2. Annulla l'operazione utilizzando l'ID operazione:

      gcloud container operations cancel OPERATION_ID \
          --location=LOCATION
      

      Sostituisci quanto segue:

      • OPERATION_ID: l'ID dell'operazione in esecuzione.
      • LOCATION: la località di computing del cluster.
  3. Avvia il rollback: invia una richiesta di patch del cluster per ripristinare la migrazione a Dataplane V1.

    gcloud container clusters update CLUSTER_NAME \
        --location=LOCATION \
        --no-enable-dataplane-v2
    

    Sostituisci quanto segue:

    • CLUSTER_NAME: il nome del cluster.
    • LOCATION: la località di computing del cluster.
  4. Osserva l'implementazione del node pool: controlla lo stato pool di nodi per verificare la migrazione al percorso dati legacy.

    gcloud container node-pools list \
        --cluster=CLUSTER_NAME \
        --location=LOCATION \
        --format='value(name, networkConfig.datapathProvider)'
    

    Sostituisci quanto segue:

    • CLUSTER_NAME: il nome del cluster.
    • LOCATION: la località di computing del cluster.

    Durante il rollback, l'output comando mostra lo stato LEGACY_DATAPATH per i node pool con patch.

  5. Osserva la finalizzazione: dopo la migrazione di tutti i node pool a Dataplane V1, GKE finalizza automaticamente la migrazione. Osserva il completamento controllando lo stato del cluster:

    gcloud container clusters describe CLUSTER_NAME \
        --location=LOCATION \
        --format='value(networkConfig.datapathProvider)'
    

    Sostituisci quanto segue:

    • CLUSTER_NAME: il nome del cluster.
    • LOCATION: la località di computing del cluster.

    Al termine del rollback, l'output comando mostra lo stato LEGACY_DATAPATH.

Risolvi i problemi di migrazione

Questa sezione fornisce informazioni per aiutarti a risolvere i problemi comuni che potresti riscontrare durante la migrazione a GKE Dataplane V2.

Migrazione del node pool non riuscita

Durante la migrazione dei node pool, GKE utilizza la strategia di upgrade di sovraccarico o di upgrade blu/verde configurata per creare nuovi nodi prima di eliminare quelli precedenti. Se la tua zona Google Cloud non dispone di risorse sufficienti per eseguire il provisioning dei nuovi nodi, la migrazione non va a buon fine e viene visualizzato un errore GCE_STOCKOUT o ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS. GKE tenta automaticamente di eseguire nuovamente la migrazione di questi pool di nodi. Se applichi le patch ai pool di nodi manualmente, attendi e riprova a eseguire la migrazione in un secondo momento, quando le risorse saranno disponibili.

Passaggi successivi