Questa pagina spiega come preparare i cluster per gli upgrade a GKE Versione 1.29. Puoi trovare i client API che effettuano chiamate alle API ritirate e rimosse nel 1,29 e aggiornare i client in modo che utilizzino le API GA. Per informazioni più dettagliate, consulta Migrazione delle API deprecate per Kubernetes .
API rimosse nella versione 1.29
Le API deprecate in Kubernetes versione 1.29 sono API beta che hanno
a GA (ad esempio v2
) o da una versione Beta a un'altra (per
esempio, da v1beta1
a v1beta2
). Le API GA offrono compatibilità a lungo termine
garanzie
e devono essere utilizzate al posto delle API beta ritirate.
Tutti gli oggetti esistenti per le API che sono passate a nuove versioni possono essere ha interagito utilizzando le API aggiornate.
Risorse di controllo del flusso
La versione API flowcontrol.apiserver.k8s.io/v1beta2
di FlowSchema e
La gestione di PriorityLevelConfiguration non è più disponibile a partire dalla versione 1.29.
Esegui la migrazione dei manifest e dei client API per utilizzare flowcontrol.apiserver.k8s.io/v1
API, disponibile a partire dalla v1.29, oppure
Versione API flowcontrol.apiserver.k8s.io/v1beta3
, disponibile dalla v1.26.
Tutti gli oggetti persistenti esistenti sono accessibili con la nuova API.
La versione API flowcontrol.apiserver.k8s.io/v1
ha i seguenti elementi
modifiche:
- Il campo PriorityLevelConfiguration
spec.limited.assuredConcurrencyShares
viene rinominata inspec.limited.nominalConcurrencyShares
e il valore predefinito è solo 30 se non specificato e il valore esplicito pari a 0 non viene modificato in 30.
La versione API flowcontrol.apiserver.k8s.io/v1beta3
ha i seguenti elementi
modifiche:
- Il campo PriorityLevelConfiguration
spec.limited.assuredConcurrencyShares
è stato rinominato inspec.limited.nominalConcurrencyShares
.
Preparazione dell'upgrade alla versione 1.29
Non è necessario eliminare e ricreare gli oggetti API. Tutti quelli esistenti gli oggetti API persistenti per le API passate a GA possono già essere letti aggiornate utilizzando le nuove versioni dell'API.
Tuttavia, ti consigliamo di eseguire la migrazione di client e manifest prima upgrade a Kubernetes 1.29. Per saperne di più, consulta API Kubernetes deprecata Migrazione Google Cloud.
Puoi visualizzare approfondimenti sul ritiro e consigli per determinare se il cluster utilizza API Kubernetes 1.29 deprecate. GKE genera insight sul ritiro quando gli user agent richiamano le API deprecate, non dalla configurazione degli oggetti Kubernetes.
Trova i cluster utilizzando le API deprecate
Puoi trovare quali cluster utilizzano API deprecate dagli insight sul ritiro. Ritiro Gli insight forniscono anche informazioni quali i client API che chiamano le API deprecate nel tuo cluster.
Puoi anche utilizzare i log di controllo per sapere quali client effettuano chiamate all'ambiente deprecato su quelle di livello inferiore.
Individua client API che effettuano chiamate di scrittura ad API deprecate
Per i cluster in cui è abilitato Google Cloud Observability, puoi utilizzare quanto segue Log di controllo dell'attività di amministrazione per mostrare l'uso delle API deprecate da parte degli user agent che non sono Gestita da Google:
resource.type="k8s_cluster"
labels."k8s.io/removed-release"="DEPRECATED_API_MINOR_VERSION"
protoPayload.authenticationInfo.principalEmail:("system:serviceaccount" OR "@")
protoPayload.authenticationInfo.principalEmail!~("system:serviceaccount:kube-system:")
Sostituisci DEPRECATED_API_MINOR_VERSION
con il minorenne
versione in cui l'API deprecata viene rimossa, ad esempio 1.22
.
Gli audit log per le attività di amministrazione vengono abilitati automaticamente per GKE cluster. Con questa query, i log mostrano gli user agent che effettuano chiamate di scrittura le API ritirate.
Individua i client API che effettuano chiamate di lettura alle API deprecate
Per impostazione predefinita, i log di controllo mostrano solo le chiamate di scrittura alle API deprecate. Per inoltre visualizza le chiamate di lettura alle API deprecate e configura gli audit log di accesso ai dati.
Segui le istruzioni per configurare gli audit log di accesso ai dati con la console Google Cloud. Nella console Google Cloud,
seleziona l'API Kubernetes Engine. Nella scheda Tipi di log del riquadro delle informazioni,
seleziona Admin Read
e Data Read
.
Con questi log abilitati, ora puoi utilizzare la query originale per visualizzare sia le letture e scrivere chiamate alle API ritirate.
Upgrade dei componenti di terze parti
Approfondimenti sul ritiro potrebbero mostrare risultati per agenti di terze parti che effettuano chiamate ad API deprecate. nel tuo cluster.
Per risolvere le chiamate degli agenti di terze parti alle API deprecate, consigliamo la seguenti best practice:
- Rivolgiti al tuo fornitore del software di terze parti per avere una versione aggiornata.
- Eseguire l'upgrade del software di terze parti alla versione più recente. Se non riesci eseguire l'upgrade del software, devi verificare se l'upgrade di GKE alla versione con le API deprecate rimosse, il tuo servizio verrà interrotto.
Ti consigliamo di eseguire questo upgrade e la versione GKE eseguire l'upgrade di un cluster di gestione temporanea per monitorare le interruzioni prima di eseguire l'upgrade cluster di produzione.
Aggiorna i cluster interessati dai ritiri
Per eseguire l'upgrade dei cluster interessati dai ritiri, segui questi passaggi:
- Controlla quali user agent utilizzano le API deprecate nella log.
- Aggiorna gli user agent che utilizzano le API deprecate in modo che utilizzino l'API supportata e versioni successive.
- Aggiornare all'ultima versione qualsiasi software di terze parti che chiama le API ritirate e versioni successive.
- Esegui l'upgrade di un cluster di test e testa la tua applicazione in un ambiente di test prima di eseguire l'upgrade del cluster di produzione per ridurre il rischio di interruzioni. quando le API deprecate non sono più disponibili.
Se non riesci ad aggiornare uno user agent interessato, esegui l'upgrade di un cluster di test separato per verificare se l'upgrade causa interruzioni del servizio. Se l'upgrade non causa interruzioni, puoi eseguire l'upgrade del cluster manualmente.
Dopo aver aggiornato tutti gli user agent, GKE attende che non ha più osservato l'utilizzo di API deprecate per 30 giorni e poi sblocca upgrade automatici. Gli upgrade automatici vengono eseguiti in base alla programmazione.
Risorse
Ulteriori informazioni sono disponibili nella documentazione di Kubernetes sul software open source:
- Blog Kubernetes:rimozioni, deprecazioni e principali cambiamenti relativi a Kubernetes Kubernetes 1,29
- Kubernetes 1.29 release note
- Migrazione delle API deprecate di Kubernetes Guida