Sequenzia l'implementazione degli upgrade dei cluster

Autopilot Standard

Rollout sequencing

• Sequenza di implementazione con fasi personalizzate
• Sequenza di implementazione basata sul parco risorse

Questo documento mostra come gestire gli upgrade dei cluster GKE con la sequenza di implementazione. Per scoprire di più su come funziona questa funzionalità, consulta Informazioni sugli upgrade dei cluster con sequenza di implementazione.

Best practice:

Utilizza la sequenza di implementazione con fasi personalizzate se stai configurando un ambiente per la prima volta.

Prima di iniziare

• Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

  gcloud init

  Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  Nota: se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
• Assicurati di avere cluster Autopilot o Standard esistenti. Per creare un nuovo cluster, vedi Crea un cluster Autopilot.
• Assicurati di aver abilitato le API richieste per i fleet. Queste API devono essere abilitate nei progetti host del parco risorse per creare qualsiasi tipo di sequenza di implementazione.
• Per le istruzioni di Terraform, assicurati di utilizzare la versione 5.13.0 o successiva del provider google.

Ruoli obbligatori

Per creare o modificare una sequenza di implementazione, devi disporre del ruolo IAM roles/gkehub.editor in ogni progetto della sequenza di implementazione. Il ruolo Fleet Editor (in precedenza GKE Hub Editor) fornisce le autorizzazioni gkehub.features.create e gkehub.fleet.update, necessarie per accedere e modificare le risorse relative al parco risorse tra i progetti. Questo ruolo fornisce le autorizzazioni necessarie per definire la strategia di upgrade, accedere e modificare le risorse pertinenti e avviare e gestire il processo di implementazione.

Se devi registrare o annullare la registrazione dei cluster in un parco risorse, devi disporre di tutte le seguenti autorizzazioni:

• Autorizzazioni di registrazione dei cluster nei progetti host del parco risorse.
• Autorizzazioni amministrative del cluster per tutti i cluster GKE da registrare.
• Autorizzazioni di registrazione dei cluster tra progetti per tutti i cluster GKE da registrare in un parco risorse in un progetto diverso.

Per saperne di più sui ruoli IAM con privilegi minimi richiesti per le diverse attività, consulta Ricevi suggerimenti sui ruoli predefiniti con l'assistenza di Gemini.

Configura una sequenza di implementazione

Questo documento spiega come creare una sequenza di implementazione utilizzando gruppi di cluster organizzati in base ai parchi risorse.

Puoi creare una sequenza di un massimo di cinque gruppi di cluster e scegliere il tempo di test di soak che preferisci dopo il completamento degli upgrade dei cluster in un gruppo (massimo 30 giorni). Puoi includere sia cluster Autopilot che Standard.

Per creare una sequenza di implementazione, i cluster devono essere organizzati in gruppi di parchi risorse. Per indicazioni su come organizzare i cluster, consulta l'esempio della banca di comunità. Dopo aver organizzato i cluster in gruppi, crei una sequenza di implementazione definendo le relazioni con i gruppi upstream e il tempo di soak di ciascun gruppo. In una sequenza di implementazione, upstream si riferisce al gruppo precedente e downstream al gruppo successivo.

Organizza i cluster in gruppi

In una sequenza di implementazione, tutti i cluster di tutti i gruppi devono essere registrati nello stesso canale di rilascio e avere la stessa versione secondaria. Se questi requisiti non vengono soddisfatti e sono presenti discrepanze di versione tra i cluster, potrebbero verificarsi problemi con l'implementazione della versione. Per saperne di più, consulta Idoneità all'implementazione basata su parco risorse.

Se hai già organizzato i cluster in parchi risorse, puoi saltare i passaggi seguenti e procedere alla sezione Crea una sequenza di implementazione.

1. Raggruppa i cluster in parchi risorse. Puoi organizzare i cluster in base ad ambienti di deployment come Test, Staging e Produzione, come mostrato nella sequenza di implementazione basata su parco risorse di esempio.

2. Registra ogni cluster in un parco risorse in base al raggruppamento scelto.

Crea una sequenza di implementazione

Una sequenza di implementazione è organizzata come un elenco collegato con un massimo di cinque elementi.

Quando crei una sequenza di implementazione, devi impostare le seguenti proprietà per ogni parco risorse di cluster:

• Gruppo upstream: il parco risorse upstream, che qualifica le nuove versioni per il gruppo downstream. Non imposti un gruppo upstream per il primo gruppo di una sequenza.

• Tempo di soak: il tempo di soak per un gruppo è il periodo che intercorre tra il completamento degli upgrade (o sono trascorsi 30 giorni dall'inizio dell'implementazione) e il momento in cui gli upgrade possono iniziare sul gruppo downstream. Per scoprire di più, consulta Come funziona la qualifica della versione in una sequenza di implementazione.

Console

1. Vai alla pagina Sequenza di implementazione nella console Google Cloud .

   Vai a Sequenza di implementazione

2. Fai clic su Crea sequenza di implementazione.

3. Nel riquadro Crea una sequenza di implementazione, seleziona i primi due parchi risorse della sequenza:

   1. Nella sezione Parco risorse 1, seleziona il primo parco risorse della sequenza.
   2. Nella sezione Tempo di soak per il parco risorse upstream, imposta il tempo di soak per il primo parco risorse utilizzando i campi Giorni, Ore e Minuti.
   3. Nella sezione Parco risorse 2, seleziona il secondo parco risorse della sequenza.
   4. Fai clic su Crea.

4. (Facoltativo) Se vuoi avere tre o più parchi risorse in questa sequenza di implementazione, segui questi passaggi aggiuntivi:

   1. Nel grafico di implementazione, fai clic sull'elemento per il secondo parco risorse.
   2. Fai clic su Aggiungi parco risorse downstream.
   3. Nella sezione Tempo di soak per il parco risorse upstream, imposta il tempo di soak per il secondo parco risorse utilizzando i campi Giorni, Ore e Minuti.
   4. Nella sezione Parco risorse successivo nella sequenza, seleziona il terzo parco risorse della sequenza.
   5. Fai clic su Salva.
   6. Ripeti i passaggi precedenti se vuoi aggiungere un quarto o un quinto parco risorse.

gcloud

Le seguenti istruzioni utilizzano il comando gcloud container fleet clusterupgrade update, ma puoi impostare le stesse proprietà con il comando gcloud container fleet clusterupgrade create.

Per ciascuno dei seguenti comandi, sostituisci SOAK_TIME con il tempo di soak del parco risorse che stai aggiornando.

Crea una sequenza di implementazione:

1. Imposta il tempo di soak per il primo parco risorse della sequenza:

   gcloud container fleet clusterupgrade update \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_FLEET_PROJECT_ID
   

   Sostituisci FIRST_FLEET_PROJECT_ID con l'ID progetto del progetto host del parco risorse.

2. Imposta il parco risorse upstream e il tempo di soak per il secondo parco risorse della sequenza:

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=FIRST_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_FLEET_PROJECT_ID
   

   Sostituisci FIRST_FLEET_PROJECT_ID con l'ID progetto del progetto host del primo parco risorse e SECOND_FLEET_PROJECT_ID con l'ID progetto del progetto host del parco risorse.

3. (Facoltativo) Se vuoi avere più di due parchi risorse in una sequenza di implementazione, imposta il parco risorse upstream per i parchi risorse successivi nella sequenza.

   Il seguente comando imposta il parco risorse upstream per il terzo parco risorse della sequenza. Se vuoi aggiungere un quarto o un quinto parco risorse, ripeti questo passaggio, seguendo lo stesso pattern per sostituire le variabili con gli ID progetto dei rispettivi progetti host del parco risorse (parco risorse precedente e parco risorse successivo).

   Nota: devi impostare un tempo di soak per ogni parco risorse, incluso l'ultimo parco risorse di una sequenza di implementazione.

   Imposta il parco risorse upstream per il parco risorse successivo nella sequenza:

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=SECOND_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_FLEET_PROJECT_ID
   

   Sostituisci SECOND_FLEET_PROJECT_ID con l'ID progetto del progetto host del secondo parco risorse e THIRD_FLEET_PROJECT_ID con l'ID progetto del progetto host del parco risorse.

Terraform

Questa sezione mostra come creare una sequenza basata su un parco risorse utilizzando Terraform. Puoi anche utilizzare questa risorsa per aggiornare la sequenza. Per saperne di più, consulta la documentazione di riferimento per google_gke_hub_feature.

Per ciascuno dei seguenti comandi, sostituisci SOAK_TIME con il tempo di soak del parco risorse che stai aggiornando.

Crea una sequenza di implementazione:

1. Aggiungi il seguente blocco alla configurazione di Terraform per impostare il tempo di soak per il primo parco risorse della sequenza:

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = []
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "FIRST_FLEET_PROJECT_ID"
   }
   

   Sostituisci FIRST_FLEET_PROJECT_ID con l'ID progetto del progetto host del parco risorse.

2. Aggiungi il seguente blocco alla configurazione di Terraform per impostare il parco risorse upstream e il tempo di soak per il secondo parco risorse della sequenza:

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["FIRST_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "SECOND_FLEET_PROJECT_ID"
   }
   

   Sostituisci FIRST_FLEET_PROJECT_ID con l'ID progetto del progetto host del primo parco risorse e SECOND_FLEET_PROJECT_ID con l'ID progetto del progetto host del parco risorse.

3. (Facoltativo) Se vuoi avere tre parchi risorse in una sequenza di implementazione, aggiungi il seguente blocco alla configurazione Terraform per impostare il parco risorse upstream per il parco risorse nella sequenza:

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["SECOND_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "THIRD_FLEET_PROJECT_ID"
   }
   

   Sostituisci SECOND_FLEET_PROJECT_ID con l'ID progetto del progetto host del secondo parco risorse e THIRD_FLEET_PROJECT_ID con l'ID progetto del progetto host del parco risorse.

   Ripeti questo passaggio se vuoi aggiungere un quarto o un quinto parco veicoli.

Controlla lo stato di una sequenza di implementazione

Puoi controllare lo stato di una sequenza di implementazione con uno dei seguenti metodi:

• Monitora una rappresentazione visiva di una sequenza di implementazione nella consoleGoogle Cloud .
• Utilizza gcloud CLI o l'API GKE Hub per controllare lo stato di una sequenza di implementazione.

Per visualizzare una sequenza di implementazione con uno dei metodi precedenti, assicurati di disporre del ruolo IAM roles/gkehub.viewer per ogni progetto host del parco risorse, soprattutto se la sequenza include parchi risorse in progetti diversi. Se non disponi delle autorizzazioni richieste per un progetto, riceverai un errore quando controlli lo stato della sequenza.

Monitora una sequenza di implementazione nella console Google Cloud

1. Vai alla pagina Sequenza di implementazione nella console Google Cloud .

   Vai a Sequenza di implementazione

2. Visualizza la sequenza nella sezione Sequenza di implementazione. Se non vedi una sequenza di implementazione, passa a un'altra sequenza di implementazione o creane una se non l'hai ancora fatto.

Come utilizzare la console per monitorare una sequenza di implementazione

In questa pagina puoi visualizzare la sequenza di implementazione associata al parco risorse del tuo progetto. Per visualizzare l'avanzamento di una sequenza di implementazione, puoi procedere nel seguente modo:

• Visualizza l'intera sequenza di implementazione, gli stati dei singoli parchi risorse e dei cluster al loro interno e il tempo di soak tra i parchi risorse. Puoi anche visualizzare la sequenza in cui non è presente un upgrade attivo, se vuoi controllare la configurazione della sequenza.
• Filtra per tipo di upgrade (upgrade del control plane o dei nodi) e versione specifica (ad esempio, 1.31.6-gke.500).

Puoi monitorare visivamente l'intera sequenza di implementazione mentre GKE esegue l'upgrade di tutti i cluster nella sequenza, qualificando una nuova versione in tutti gli ambienti prima di eseguire l'upgrade dei cluster dell'ambiente di produzione. Durante il monitoraggio, puoi gestire una sequenza di implementazione, apportando le modifiche necessarie.

Passa a un'altra sequenza di implementazione

Questa pagina della console Google Cloud mostra la sequenza di implementazione se il progetto attivo è un progetto host del parco risorse per un parco risorse registrato in una sequenza di implementazione.

Se vuoi visualizzare una sequenza di implementazione diversa, utilizza il selettore di progetti nella parte superiore della pagina della console Google Cloud per selezionare un progetto host del parco risorse associato a una sequenza di implementazione diversa.

Utilizza gcloud CLI

Puoi controllare lo stato di una sequenza di implementazione, di un parco risorse nella sequenza o di singoli cluster all'interno di un parco risorse.

• Per controllare lo stato di una sequenza di implementazione basata sul parco risorse, esegui questo comando:

  gcloud container fleet clusterupgrade describe \
      --show-linked-cluster-upgrade --project=FLEET_PROJECT_ID
  

  Sostituisci FLEET_PROJECT_ID con l'ID progetto del progetto host per qualsiasi parco risorse della sequenza. Per un elenco completo dei flag, consulta la documentazione di riferimento gcloud container fleet clusterupgrade describe.

• Per controllare lo stato di un solo parco risorse nella sequenza, nel comando precedente, sostituisci il flag --show-linked-cluster-upgrade con il flag --show-cluster-upgrade.

• Per controllare lo stato dei singoli cluster all'interno di un parco risorse, esegui questo comando nel progetto host del parco risorse e consulta la sezione membershipStates:

  gcloud container fleet features describe clusterupgrade
  

La sezione seguente descrive le informazioni sullo stato nell'output risultante.

Informazioni sullo stato di una sequenza di implementazione

Quando controlli lo stato dell'implementazione di una versione, puoi visualizzare l'avanzamento di ogni gruppo e cluster all'interno di quel gruppo.

Consulta la tabella seguente per i potenziali stati di un cluster o di un gruppo:

Stato	Per un singolo cluster	Per un parco risorse
NON IDONEO	Questo cluster non è idoneo per questo upgrade	Uno o più cluster di questo gruppo non sono idonei per questo upgrade.
IN ATTESA	L'upgrade è in attesa sul cluster o su alcuni dei suoi pool di nodi Standard o gruppi di nodi in un cluster Autopilot.	L'upgrade non è stato avviato su nessuno dei cluster del gruppo.
IN_PROGRESS	L'upgrade è in corso sul cluster.	L'upgrade è iniziato su almeno un cluster, ma non è stato completato su tutti i cluster.
IN AMMOLLO	L'upgrade è stato completato sul cluster, ma non è ancora terminata la fase di soaking.	L'upgrade è stato completato su tutti i cluster, ma non è ancora terminata la fase di soaking.
FORCED_SOAKING	L'upgrade ha richiesto più tempo del previsto (30 giorni), pertanto abbiamo forzato l'ingresso nella fase di soak. L'upgrade può comunque continuare nel cluster.	L'upgrade ha richiesto più tempo del previsto (30 giorni), pertanto abbiamo forzato l'ingresso nella fase di soak. L'upgrade può comunque continuare nei cluster.
COMPLETA	L'upgrade viene considerato "completato", il che significa che l'upgrade è stato completato su questo cluster.	L'upgrade viene considerato "completato" e pronto per essere utilizzato dal gruppo downstream, il che significa che l'upgrade ha terminato il periodo di attesa.

Nell'output di questi comandi, gli attributi clusterUpgrade(s).spec e clusterUpgrade(s).state contengono informazioni aggiuntive sull'upgrade del cluster, come il tempo di soak, gli override dell'upgrade del cluster e lo stato dell'upgrade.

Gestisci una sequenza di implementazione

Puoi controllare gli upgrade automatici dei cluster con la sequenza di implementazione in diversi modi, spiegati nelle sezioni seguenti.

Modifica il tempo di soak per un gruppo

Puoi modificare il tempo di soak predefinito per un gruppo o modificarlo per l'upgrade del gruppo a una versione specifica. Il periodo di tempo massimo è 30 giorni.

Aggiorna il tempo di soak predefinito

Puoi aggiornare il tempo di soak predefinito nella console Google Cloud o con gcloud CLI.

Console

1. Vai alla pagina Sequenza di implementazione nella console Google Cloud .

   Vai a Sequenza di implementazione

2. Visualizza la sequenza nella sezione Sequenza di implementazione. Se non vedi una sequenza di implementazione, passa a un'altra sequenza di implementazione o creane una se non l'hai ancora fatto.

3. Nel Grafico di implementazione, fai clic sull'elemento Tempo di soak dopo l'elemento del parco risorse in cui vuoi aggiornare il tempo di soak.

4. Fai clic su Modifica tempo di soak.

5. Nella sezione Imposta un nuovo tempo di soak, inserisci un nuovo tempo di soak utilizzando i campi Giorni, Ore e Minuti.

6. Per salvare le impostazioni, fai clic su Salva.

gcloud

Per modificare il tempo di soak predefinito per un gruppo, utilizza i comandi gcloud CLI delle istruzioni per creare una sequenza di implementazione, omettendo i flag per impostare il gruppo upstream.

Sostituisci il tempo di soak predefinito

Puoi modificare il tempo di soak per l'implementazione di una versione specifica in modo che sia diverso dal tempo di soak predefinito per il gruppo. Ad esempio, se hai già qualificato una nuova versione e vuoi che gli upgrade inizino nel gruppo successivo, puoi impostare il tempo di soak su zero. Puoi utilizzarlo anche se vuoi più tempo rispetto al tempo di soak predefinito per qualificare una versione specifica.

Poiché il tempo di soak è impostato per gruppo, se vuoi eseguire l'override del tempo di soak per altri gruppi in questa sequenza, aggiornali utilizzando lo stesso comando con il nome del parco risorse sostituito.

Per le istruzioni riportate in questa sezione, sostituisci le seguenti variabili:

• SOAK_TIME: il tempo di soak da utilizzare diverso da quello predefinito (ad esempio, "0d" se vuoi saltare il tempo di soak per l'implementazione di una versione).
• UPGRADE_NAME: il tipo di upgrade, k8s_control_plane per gli upgrade del control plane o k8s_node per gli upgrade dei nodi.

• VERSION: la versione di GKE in cui vuoi eseguire l'override del tempo di soak predefinito dopo l'implementazione della versione (ad esempio 1.25.2-gke.400) in questo gruppo.

gcloud

Esegui questo comando nel progetto host del parco risorse in cui vuoi eseguire l'override del tempo di soak utilizzato per l'implementazione di una versione specifica.

gcloud container fleet clusterupgrade update
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

Terraform

Aggiungi il seguente blocco gke_upgrades_overrides alla configurazione di Terraform all'interno del blocco clusterupgrade per eseguire l'override del tempo di soak utilizzato per l'implementazione di una versione specifica:

gke_upgrade_overrides {
    upgrade {
      name = "UPGRADE_NAME"
      version = "VERSION"
    }
    post_conditions {
      soaking = "SOAK_TIME"
    }
  }

Aggiorna i gruppi in una sequenza di implementazione

Puoi aggiornare una sequenza di implementazione esistente per aggiungere, rimuovere o modificare l'ordine dei gruppi nella sequenza. Per apportare queste modifiche, aggiorna le associazioni tra i gruppi.

Puoi eseguire questi passaggi nella console Google Cloud o con gcloud CLI.

Console

1. Vai alla pagina Sequenza di implementazione nella console Google Cloud .

   Vai a Sequenza di implementazione

2. Visualizza la sequenza nella sezione Sequenza di implementazione. Se non vedi una sequenza di implementazione, passa a un'altra sequenza di implementazione o creane una se non l'hai ancora fatto.

3. Nel Grafico di implementazione, fai clic sugli elementi dei parchi risorse esistenti nella sequenza. Dopo aver fatto clic su questi elementi, puoi eseguire alcune delle seguenti azioni per apportare le modifiche:

   • Fai clic su Aggiungi parco risorse downstream.
   • Fai clic su Aggiungi parco risorse upstream.
   • Fai clic su Rimuovi parco risorse.

Puoi eseguire azioni come le seguenti:

• Aggiungi un altro parco risorse alla fine della sequenza di implementazione aggiungendo un parco risorse downstream all'ultimo parco risorse della sequenza.
• Aggiungi un altro parco risorse all'inizio della sequenza di implementazione aggiungendo un parco risorse upstream al primo parco risorse della sequenza.
• Modifica l'ordine dei parchi risorse nella sequenza di implementazione rimuovendoli e aggiungendoli di nuovo con un parco risorse upstream o downstream diverso.
• Rimuovi il primo parco risorse nella sequenza di implementazione.
• Rimuovi l'ultimo parco risorse nella sequenza di implementazione.
• Rimuovere il parco risorse intermedio nella sequenza di implementazione, dopo aver rimosso il primo o l'ultimo parco risorse della sequenza.

gcloud

Per aggiungere o modificare i parchi risorse upstream, utilizza il comando gcloud container fleet clusterupgrade update con il flag --upstream-fleet. Per rimuovere un parco risorse upstream, utilizza il flag --reset-upstream-fleet.

Puoi eseguire azioni come le seguenti:

• Aggiungi un altro parco risorse all'inizio della sequenza di implementazione aggiungendo un parco risorse upstream al primo parco risorse della sequenza.
• Modifica l'ordine dei parchi risorse nella sequenza di implementazione modificando le associazioni dei parchi risorse upstream.
• Rimuovi il primo parco risorse nella sequenza di implementazione rimuovendo il parco risorse upstream del secondo parco risorse.

Ritarda il completamento dell'implementazione della versione del gruppo

Se devi impedire temporaneamente a un gruppo di completare l'implementazione di una nuova versione nei suoi cluster, puoi aggiungere un'esclusione di manutenzione a uno qualsiasi dei cluster per cui non è stato eseguito l'upgrade alla versione di destinazione. In questo modo, un gruppo può essere messo in pausa prima di passare al tempo di soak o al gruppo downstream per un massimo di 30 giorni. Dopo 30 giorni, il gruppo inizierà la fase di soaking.

Puoi anche modificare il tempo di soak per quel gruppo impostandolo su 30 giorni per massimizzare il tempo di attesa della sequenza di implementazione prima di passare al gruppo successivo.

Se devi ritardare ulteriormente l'inizio degli upgrade per il gruppo successivo, puoi utilizzare le esclusioni di manutenzione per i cluster del gruppo successivo.

Elimina una sequenza

Per eliminare una sequenza, rimuovi le associazioni upstream per ciascuno dei gruppi, ad eccezione del primo. Il primo gruppo non ha un gruppo upstream.

Puoi eseguire questi passaggi nella console Google Cloud o con gcloud CLI.

Console

1. Vai alla pagina Sequenza di implementazione nella console Google Cloud .

   Vai a Sequenza di implementazione

2. Visualizza la sequenza nella sezione Sequenza di implementazione. Se non vedi una sequenza di implementazione, passa a un'altra sequenza di implementazione o creane una se non l'hai ancora fatto.

3. Nel grafico di implementazione, fai clic sull'elemento dell'ultimo parco risorse.

4. Fai clic su Rimuovi parco risorse.

5. Per rimuovere il parco veicoli, fai clic su Rimuovi.

6. Ripeti i tre passaggi precedenti finché non rimane solo il primo parco risorse.

   Operazione riuscita: dopo aver eliminato la connessione rimanente tra i parchi risorse, il grafico di implementazione continua a mostrare un parco risorse senza connessioni. Se questo è lo stato, hai eliminato correttamente la sequenza di implementazione.

gcloud

Esegui questo comando nel progetto host del parco risorse di ciascuno dei parchi risorse nella sequenza di implementazione, escluso il primo parco risorse:

gcloud container fleet clusterupgrade update --reset-upstream-fleet

Risoluzione dei problemi

Risolvi i problemi di idoneità dell'implementazione

Se non tutti i cluster di una sequenza di implementazione hanno lo stesso target di upgrade, GKE potrebbe non essere in grado di procedere con gli upgrade dei cluster. Gli upgrade automatici non possono procedere se un gruppo upstream non qualifica un target di upgrade da passare al gruppo downstream. Inoltre, gli upgrade automatici non possono procedere se i cluster nel gruppo upstream qualificano un target di upgrade non valido per i cluster nel gruppo downstream.

Per verificare se la sequenza di implementazione presenta problemi di idoneità, controlla lo stato della sequenza di implementazione. Se un gruppo non è idoneo, segui le istruzioni per visualizzare lo stato dei singoli cluster di un gruppo.

Per far avanzare immediatamente gli upgrade dei cluster, rimuovi tutti i cluster con lo stato INELIGIBLE seguendo le istruzioni per far avanzare le implementazioni parzialmente idonee.

Correggi l'idoneità in un gruppo

In un gruppo, se un cluster non è idoneo perché è su una versione precedente (ad esempio, la maggior parte dei cluster nel gruppo viene sottoposta ad upgrade dalla versione 1.23 alla 1.24 e un cluster è sulla versione 1.22), puoi eseguire manualmente l'upgrade del cluster alla versione 1.24 per risolvere la discrepanza della versione.

In un gruppo, GKE ignora i cluster con versioni successive rispetto al target di upgrade automatico. Questi cluster non impediscono l'avanzamento degli upgrade al gruppo downstream.

Correggi l'idoneità tra i gruppi

Tra i gruppi, se esiste una mancata corrispondenza nei target di upgrade in cui il gruppo downstream è su una versione più recente (ad esempio, il gruppo upstream ha eseguito l'upgrade dalla versione 1.23 alla 1.24 e i cluster nel gruppo downstream sono sulla versione 1.25), puoi eseguire manualmente l'upgrade dei cluster nel gruppo upstream alla versione 1.25 per assicurarti che gli upgrade procedano.

Tra i gruppi, se esiste una mancata corrispondenza nei target di upgrade in cui il gruppo downstream è su una versione precedente (ad esempio, è stato eseguito l'upgrade del gruppo upstream dalla versione 1.24 alla 1.25 e i cluster nel gruppo downstream sono sulla versione 1.23), puoi eseguire manualmente l'upgrade dei cluster nel gruppo downstream alla versione 1.24 o 1.25 per assicurarti che gli upgrade procedano. Se GKE ha eseguito l'upgrade del gruppo upstream a una versione per cui il gruppo downstream è idoneo, GKE esegue l'upgrade dei cluster nel gruppo downstream a quel target di upgrade. In questo caso, non è necessario eseguire l'upgrade manuale dei cluster per sbloccare la sequenza. Per saperne di più, consulta Il gruppo upstream ha qualificato più target di upgrade per il gruppo downstream.

Avanza i rollout parzialmente idonei

Se gli upgrade dei cluster in un gruppo non vengono completati a causa di problemi con l'idoneità all'implementazione (ad esempio, discrepanze di versione all'interno di un gruppo), puoi rimuovere i cluster non idonei per la versione di destinazione dell'upgrade del gruppo da un gruppo per completare l'implementazione della versione e iniziare il tempo di soak o passare al gruppo successivo nella sequenza di implementazione. Puoi anche rimuovere un cluster da un gruppo per altri motivi, ad esempio se l'utilizzo di questo cluster non è più correlato agli altri cluster del gruppo.

Segui le istruzioni per annullare la registrazione di un cluster da un parco risorse.

Dopo aver rimosso tutti i cluster che impediscono il completamento dell'implementazione della versione di un gruppo, l'implementazione della versione del gruppo verrà completata. Per confermarlo, segui le istruzioni per controllare lo stato di un'implementazione della versione.

Passaggi successivi

• Informazioni sugli upgrade dei cluster con sequenza di implementazione