Modernizzazione del control plane gestito

Panoramica

Google aggiornerà gradualmente i parchi risorse esistenti che utilizzavano l'implementazione del control plane gestito ISTIOD per utilizzare l'implementazione TRAFFIC_DIRECTOR. Per impostazione predefinita, Google eseguirà automaticamente la migrazione dei parchi risorse, ma puoi scegliere di gestirla autonomamente. Per verificare quale control plane utilizza il tuo parco risorse, consulta Controlla l'implementazione del control plane.

Quando prepari il parco risorse per la modernizzazione, tieni presente quanto segue:

  1. Per prepararti alla modernizzazione, hai due modi per controllare la procedura:

    • Migrazione automatica gestita da Google (impostazione predefinita): puoi personalizzare l'ordine in cui i cluster vengono modernizzati seguendo le istruzioni riportate in Modernizzazione gestita da Google.

    • Migrazione gestita dal cliente (facoltativa): puoi scegliere di gestire autonomamente la modernizzazione dei parchi risorse etichettandoli seguendo le istruzioni riportate in Modernizzazione gestita dal cliente.

  2. Per valutare automaticamente il parco risorse in base alle funzionalità supportate e identificare potenziali lacune di blocco prima della modernizzazione, consulta la guida alla comprensione della compatibilità di Cloud Service Mesh.

  3. La modernizzazione gestita da Google è l'impostazione predefinita. Con questa opzione, Google determina quando i parchi risorse sono pronti per la modernizzazione. Google pianifica la modernizzazione dei parchi risorse e ti invia una notifica prima di avviare la procedura.

  4. La modernizzazione di un cluster riavvierà i carichi di lavoro con i proxy. Se segui le best practice di Kubernetes, non dovresti riscontrare tempi di inattività. In oltre, se hai configurato un periodo di manutenzione durante unafinestra , Google attiverà la modernizzazione durante questo periodo. Una volta avviata, la modernizzazione viene eseguita fino al completamento, con un tempo di attesa aggiuntivo di 6 giorni prima di essere contrassegnata come finalizzata. Se il monitoraggio rileva problemi, puoi richiedere un rollback.

  5. Per la modernizzazione gestita dal cliente: puoi utilizzare la guida alla comprensione della compatibilità di Cloud Service Mesh per determinare la compatibilità con l'implementazione del TRAFFIC_DIRECTOR control plane. Puoi quindi scegliere quando attivare la modernizzazione del parco risorse.

  6. Una volta modernizzato un parco risorse, Google rimuove tutti i componenti basati su Istiod.

  7. L'implementazione del control plane TRAFFIC_DIRECTOR richiede che il cluster sia registrato in un parco risorse con la funzionalità mesh abilitata. Se hai eseguito l'onboarding utilizzando strumenti legacy, Google registrerà automaticamente il cluster nel parco risorse del progetto utilizzando l'API Membership gkehub.googleapis.com. Se hai un'automazione che annulla la registrazione di un cluster, devi rimuoverla prima della modernizzazione.

Modernizzazione gestita da Google

Questa opzione è l'impostazione predefinita se non etichetti i parchi risorse per la modernizzazione gestita dal cliente. Google monitorerà i parchi risorse per determinare quando sono pronti per essere modernizzati in modo sicuro. Quando tutti i parchi risorse abilitati per mesh nella tua organizzazione sono pronti, verrà pianificata la modernizzazione della tua organizzazione.

Più parchi risorse

Se la tua organizzazione ha più parchi risorse con Cloud Service Mesh gestito, puoi controllare l'ordine in cui Google modernizza i parchi risorse impostando un' etichetta di progetto mesh-modernization-order su uno dei valori: early, default, late. Google completerà la modernizzazione di ogni gruppo prima di iniziare la modernizzazione di qualsiasi parco risorse nel gruppo successivo. I parchi risorse per cui hai scelto la modernizzazione gestita dal cliente non verranno presi in considerazione in questo ordine.

Utilizza il seguente comando per impostare l'etichetta mesh-modernization-order per un parco risorse:

gcloud alpha projects update FLEET_PROJECT_ID --update-labels="mesh-modernization-order=VALUE"

Per istruzioni su come impostare le etichette di progetto utilizzando la console o REST, consulta il documento Creazione e gestione delle etichette.

Se non utilizzi le Google Cloud organizzazioni, i parchi risorse verranno pianificati e modernizzati in modo indipendente e non potrai controllare l'ordine.

Mesh multi-cluster

Se un parco risorse ha più cluster che utilizzano Cloud Service Mesh gestito, puoi controllare l'ordine in cui Google modernizza i cluster impostando l'etichetta del cluster di mesh-modernization-order su uno dei valori: early, default, late. Google inizierà la modernizzazione di ogni gruppo e attenderà il completamento dei passaggi di modernizzazione automatica prima di iniziare la modernizzazione di qualsiasi cluster nel gruppo successivo. Tieni presente che questo ordine verrà applicato solo all'interno di un parco risorse e non influirà su altri parchi risorse della tua organizzazione che potrebbero essere modernizzati in parallelo.

Utilizza il seguente comando per impostare l'etichetta mesh-modernization-order per un cluster:

gcloud container clusters update CLUSTER_NAME \
  --location LOCATION \
  --update-labels="mesh-modernization-order=VALUE"

Notifiche e pianificazione

Questa sezione descrive come riceverai una notifica della modernizzazione imminente dei parchi risorse e dei cluster.

Notifica che la modernizzazione verrà pianificata a breve

Innanzitutto, riceverai una notifica quando i parchi risorse sono stati selezionati per la modernizzazione gestita da Google nelle prossime settimane.

Questa notifica verrà inviata prima del primo giorno lavorativo statunitense di un mese. La prima data di inizio possibile per la modernizzazione del cluster è 14 giorni dopo il primo giorno lavorativo statunitense di un mese e Google farà del suo meglio per iniziare la prima modernizzazione del cluster per la tua organizzazione entro la fine del mese di calendario successivo. Ad esempio, le notifiche saranno attive prima del 1° aprile 2025, le modernizzazioni dei cluster potrebbero iniziare a partire dal 15 aprile 2025 e la prima modernizzazione del cluster dovrebbe iniziare prima del 31 maggio 2025.

Riceverai una notifica contemporaneamente per ciascuno dei parchi risorse della tua organizzazione (esclusi quelli per cui hai scelto la modernizzazione gestita dal cliente).

Questa notifica è disponibile nelle condizioni dello stato della funzionalità a livello di parco risorse (MODERNIZATION_WILL_BE_SCHEDULED). Per informazioni dettagliate sul controllo delle condizioni, consulta Controlla lo stato della modernizzazione.

Notifica a livello di cluster che la modernizzazione è pianificata

Riceverai una notifica, a livello di cluster, della data di inizio stimata per la modernizzazione gestita da Google di quel cluster, almeno 1 giorno prima dell'inizio della modernizzazione del cluster.

Dopo la notifica a livello di parco risorse, questa notifica ti fornisce una tempistica molto più precisa della modernizzazione dei singoli cluster.

Questa notifica è disponibile nelle condizioni dello stato della funzionalità a livello di cluster (MODERNIZATION_SCHEDULED). Per informazioni dettagliate sul controllo delle condizioni, consulta Controlla lo stato della modernizzazione.

Modernizzazione attiva per la migrazione gestita da Google

Questa sezione descrive i passaggi della modernizzazione gestita da Google.

Modernizzazione dei parchi risorse

Google attiverà la modernizzazione attiva di ciascuno dei parchi risorse della tua organizzazione. Ciò significa che per ogni parco risorse vengono eseguiti i seguenti passaggi:

  1. Modernizza tutti i cluster con mesh-modernization-order impostato su early.
  2. Modernizza tutti i cluster con mesh-modernization-order impostato su default o non specificato.
  3. Modernizza tutti i cluster con mesh-modernization-order impostato su late.
  4. Attendi che la modernizzazione di ogni cluster venga contrassegnata come finalizzata. Ciò significa attendere almeno 6 giorni lavorativi dopo il riavvio dell'ultimo pod in qualsiasi cluster di questo parco risorse.
  5. Finalizza la modernizzazione di questo parco risorse, rimuovendo infine i componenti basati su Istiod.

Per monitorare lo stato di modernizzazione attivo dei parchi risorse, consulta Controlla lo stato della modernizzazione.

Modernizzazione di un cluster

Durante la modernizzazione attiva di un cluster, entrambe le implementazioni del control plane vengono eseguite temporaneamente in parallelo e, in modo sicuro e controllato, vengono elaborate le seguenti attività:

  1. Abilita la nuova implementazione del control plane. Se hai configurato periodi di manutenzione per il cluster e utilizzi la modernizzazione gestita da Google, questo passaggio inizierà durante un periodo di manutenzione e continuerà fino al completamento. Tieni presente i seguenti dettagli:
  2. Shift il traffico alla nuova implementazione del control plane. Se hai configurato periodi di manutenzione per il cluster e utilizzi la modernizzazione gestita da Google, questo passaggio inizierà durante un periodo di manutenzione e continuerà fino al completamento. Tieni presente i seguenti dettagli:
    • I pod gestiti dal deployment di Kubernetes che hanno proxy Cloud Service Mesh vengono riavviati, in modo che si ricolleghino al nuovo control plane.
    • I pod vengono riavviati in ondate di dimensioni sempre maggiori con un tempo di attesa dopo ogni ondata per il monitoraggio.
  3. È previsto un tempo di attesa di almeno 6 giorni lavorativi prima che la modernizzazione di un cluster venga contrassegnata come finalizzata.

Per monitorare lo stato di modernizzazione attivo dei cluster, consulta Controlla lo stato della modernizzazione.

Modernizzazione gestita dal cliente

Puoi scegliere di controllare autonomamente la tempistica esatta della modernizzazione a livello di parco risorse. Per farlo, applica un' etichetta al progetto host del parco risorse utilizzando il seguente comando:

gcloud alpha projects update FLEET_PROJECT_ID \
  --update-labels="mesh-modernization-mode=manual"

Tieni presente che se la tua Google Cloud organizzazione ha più parchi risorse, tutti i parchi risorse senza etichetta verranno pianificati per la modernizzazione gestita da Google.

Una volta che il parco risorse è idoneo per la modernizzazione, riceverai una notifica nello stato della funzionalità a livello di parco risorse. Devi attivare la modernizzazione entro 3 mesi dalla ricezione di questa notifica.

Consulta le seguenti best practice di configurazione obbligatorie per preparare il cluster alla modernizzazione. Iscriviti al feed delle note di rilascio di Cloud Service Mesh per ricevere una notifica.

Controlla lo stato della modernizzazione

Puoi monitorare lo stato di modernizzazione dei parchi risorse e dei cluster controllando le condizioni dello stato della funzionalità. Utilizza il seguente comando Google Cloud CLI:

gcloud alpha container fleet mesh describe --project FLEET_PROJECT_ID

Condizioni a livello di parco risorse

Quando controlli lo stato del parco risorse, potresti visualizzare le seguenti condizioni in state.servicemesh.conditions:

  • MODERNIZATION_WILL_BE_SCHEDULED: a breve pianificheremo la modernizzazione dei cluster in questo parco risorse per utilizzare l'implementazione del control plane TRAFFIC_DIRECTOR.
  • MODERNIZATION_MODERNIZING: la modernizzazione è in corso per uno o più cluster nel parco risorse.
  • MODERNIZATION_MODERNIZED: la modernizzazione di tutti i cluster nel parco risorse è stata completata correttamente. Il parco risorse è ora in un periodo di attesa durante il quale i rollback sono ancora possibili.
  • MODERNIZATION_FINALIZED: la modernizzazione è completa e finalizzata. Il rollback non è più possibile. Una volta raggiunto questo stato del parco risorse, i cluster smettono di segnalare MODERNIZATION_COMPLETED. Questo stato verrà segnalato per almeno 30 giorni dopo il completamento della migrazione.
  • MODERNIZATION_ROLLING_BACK_FLEET: è in corso un rollback a livello di parco risorse.

Condizioni a livello di cluster

Quando controlli lo stato dei singoli cluster nel parco risorse, potresti visualizzare le seguenti condizioni in membershipStates.servicemesh.conditions:

  • MODERNIZATION_SCHEDULED: la modernizzazione di questo cluster è stata pianificata per la data specificata nei dettagli della condizione o per una data successiva.
  • MODERNIZATION_IN_PROGRESS: la modernizzazione di questo cluster è in corso.
  • MODERNIZATION_COMPLETED: la modernizzazione di questo cluster è stata completata.
  • MODERNIZATION_ROLLING_BACK_CLUSTER: è in corso un rollback per questo cluster.
  • MODERNIZATION_ABORTED: è stato eseguito il rollback del cluster al control plane legacy. Questo stato viene segnalato per 24 ore dopo il completamento del rollback.