Questa pagina mostra come visualizzare approfondimenti e consigli su Ritiri di Kubernetes per i tuoi cluster Google Kubernetes Engine (GKE). Per ulteriori informazioni per saperne di più su come gestire i ritiri di Kubernetes con GKE, consulta Ritiri di GKE.
Che cosa sono gli approfondimenti e i consigli sul ritiro?
Quando GKE rileva che un cluster sta utilizzando una funzionalità Kubernetes o che è deprecata e verrà rimossa in un'imminente versione secondaria, si verifica quanto segue:
- Upgrade automatico alla versione secondaria successiva è in pausa. Per scoprire di più su come funziona, consulta Cosa succede quando GKE mette in pausa gli upgrade automatici.
- Vengono generati approfondimenti e suggerimenti che ti consentono di valutare per mitigare l'esposizione del cluster al ritiro.
Gli insight e i suggerimenti sul ritiro sono disponibili dal motore per suggerimenti. che fornisce insight e suggerimenti per l'utilizzo delle risorse in Google Cloud. Per scoprire di più su come funziona il motore per suggerimenti per GKE, consulta Ottimizza l'utilizzo di GKE con insight e suggerimenti.
Per l'argomento Ritiri con il motore per suggerimenti:
- Un approfondimento spiega che il cluster utilizza una funzionalità o un'API che è deprecata e verrà rimossa in un'imminente versione secondaria.
- Un suggerimento fornisce indicazioni su cosa fare per ridurre il rischio al ritiro.
Ad esempio, un insight potrebbe spiegare che il cluster utilizza un'API beta è deprecato e verrà rimosso nella prossima versione secondaria. La spiega che è consigliabile eseguire la migrazione dei carichi di lavoro le API beta all'uso delle API v1. Ogni consiglio include un riferimento a un guida alla migrazione per la funzionalità o l'API deprecata. Questa guida alla migrazione fornisce disponibile nella tabella corrispondente per i ritiri di Kubernetes.
Quando GKE genera una coppia di insight e suggerimenti, copre
Utilizzo di API o funzionalità Kubernetes deprecate in un determinato
insight per un cluster nel tuo progetto. Per
Ad esempio, se uno user agent chiama una delle API indirizzate
il sottotipo DEPRECATION_K8S_1_22_V1BETA1_API
, un approfondimento e un consiglio
consigliano di eseguire la migrazione del cluster utilizzando queste API. Se
che in un altro cluster utilizza queste API, GKE genera un'altra
insight e suggerimenti.
Utilizzo di funzionalità e API Kubernetes deprecate rilevate da GKE
Ritiro | Rimosso nella versione GKE | Sottotipo di insight |
---|---|---|
Certificati TLS firmati con l'algoritmo SHA-1 | 1,29 | DEPRECATION_K8S_SHA_1_CERTIFICATE |
API deprecate per Kubernetes 1.29 | 1,29 | DEPRECATION_K8S_1_29_API |
API deprecate per Kubernetes 1.27 | 1,27 | DEPRECATION_K8S_1_27_API |
API deprecate per Kubernetes 1.26 | 1,26 | DEPRECATION_K8S_1_26_API |
API deprecate per Kubernetes 1.25 | 1,25 | DEPRECATION_K8S_1_25_API |
PodSecurityPolicy | 1,25 | DEPRECATION_K8S_1_25_PODSECURITYPOLICY |
Immagini dei nodi basate su Docker | 1,24 | DEPRECATION_K8S_1_24_DOCKERSHIM |
Campo X.509 Common Name nei certificati webhook | 1,23 | DEPRECATION_K8S_1_23_CERTIFICATE |
API deprecate per Kubernetes 1.22,
API Kubernetes Ingress Beta rimosse in GKE 1.23 |
1,22, 1,23 | DEPRECATION_K8S_1_22_V1BETA1_API |
Ricorda che per i prossimi ritiri, devi valutare in modo indipendente l'esposizione del tuo cluster e mitigare problemi.
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Attiva l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine .
- Se vuoi utilizzare Google Cloud CLI per questa attività,
install e poi
inizializzare
con gcloud CLI. Se hai già installato gcloud CLI, scarica la versione più recente
eseguendo
gcloud components update
.
Ruoli obbligatori
Assicurati di disporre delle autorizzazioni necessarie per gli insight e uno o più suggerimenti, in base alle seguenti ruoli di base o ruoli predefiniti:
Visualizza insight e suggerimenti con uno dei seguenti ruoli:
Visualizza e aggiorna lo stato di approfondimenti e consigli (ad esempio ignora un consiglio):
Visualizza approfondimenti e consigli
Puoi visualizzare insight e suggerimenti con Google Cloud CLI, nell' Console Google Cloud o con l'API Recommender.
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud:
Controlla la colonna Notifiche per cluster specifici al fine di trovare insight.
Fai clic sull'insight per visualizzare ulteriori informazioni. Nella barra laterale visualizzata puoi vedere i dettagli di questo approfondimento, inclusi eventuali un consiglio per i nostri esperti.
gcloud
In genere, un insight ha un suggerimento corrispondente. Gli insight sono
recuperato con gcloud recommender insights
e i suggerimenti vengono recuperati con gcloud recommender recommendations
.
Visualizza l'elenco di insight per i cluster di una zona specifica (per i cluster cluster) o una regione specifica (per i cluster a livello di regione):
gcloud recommender insights list \ --insight-type=google.container.DiagnosisInsight \ --location=LOCATION \ --project=PROJECT_ID \ --format=FORMAT \ --filter="insightSubtype:SUBTYPE"
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google Cloud per il progetto in cui si trovano i cluster.LOCATION
: la regione o la zona esatta del cluster. Per i cluster di zona, devi fornire la zona esatta (ad es.us-central1-c
). Per i cluster regionali, devi fornire la regione esatta (ad es.us-central1
).FORMAT
: cambia il formato di output in YAML. Questo flag è facoltativo.SUBTYPE
: un sottotipo di insight, ad esempioDEPRECATION_K8S_1_23_CERTIFICATE
. Questo limita l'output agli insight di un sottotipo specificato. Questo flag è facoltativo.
In alternativa, se disponi già di un ID approfondimento, puoi visualizzare i dettagli relativi insight eseguendo questo comando:
gcloud recommender insights describe INSIGHT \ --insight-type=google.container.DiagnosisInsight \ --location=LOCATION \ --project=PROJECT_ID \ --format=FORMAT
Sostituisci
INSIGHT
con il valore dell'ID insight, specificato alla fine dell'URL dal camponame
per l'approfondimento.L'output include ulteriori dettagli sul comportamento GKE ha rilevato contenuti insieme al tuo cluster.
Visualizza l'elenco di suggerimenti per i cluster di una zona specifica (ad cluster di zona) o una regione specifica (per i cluster a livello di regione):
gcloud recommender recommendations list \ --recommender=google.container.DiagnosisRecommender \ --location=LOCATION \ --project=PROJECT_ID \ --format=FORMAT \ --filter="recommenderSubtype:SUBTYPE"
Sostituisci
SUBTYPE
con un sottotipo di motore per suggerimenti, ad esempioDEPRECATION_K8S_1_23_CERTIFICATE
. Questo limita l'output ai suggerimenti di un sottotipo specifico. Questo flag è facoltativo.In alternativa, se disponi già di un ID consiglio, puoi visualizzare eseguendo questo comando:
gcloud recommender recommendations describe RECOMMENDATION_ID \ --recommender=google.container.DiagnosisRecommender \ --location=LOCATION \ --project=PROJECT_ID \ --format=FORMAT
Sostituisci
RECOMMENDATION_ID
con il valore salvato diassociatedRecommendations.recommendation
dall'output comando in Passaggio 1:L'output fornisce indicazioni sull'azione che potresti dover intraprendere per ottimizzare l'utilizzo di GKE da parte del tuo cluster.
API
A ogni insight è associato un suggerimento. Gli insight vengono recuperati con Risorsa REST: projects.locations.insightTypes.insights e i suggerimenti vengono recuperati Risorsa REST: projects.locations.recommendationers.recommendations.
Visualizza l'elenco di insight per i cluster di una zona specifica (per i cluster cluster) o una regione specifica (per i cluster a livello di regione):
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.container.DiagnosisInsight/insights?filter=insightSubtype%20%3D%20SUBTYPE
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto Google Cloud per il progetto in cui si trovano i cluster.LOCATION
: la regione o la zona esatta del cluster. Per i cluster di zona, devi fornire la zona esatta (ad es.us-central1-c
). Per i cluster regionali, devi fornire la regione esatta (ad es.us-central1
).SUBTYPE
: un sottotipo di insight, ad esempioDEPRECATION_K8S_1_23_CERTIFICATE
. Questo limita l'output agli insight di un sottotipo specificato. Questo flag è facoltativo.
In alternativa, se disponi già di un ID approfondimento, puoi visualizzare i dettagli relativi insight tramite la richiesta seguente:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.container.DiagnosisInsight/insights/INSIGHT
Sostituisci
INSIGHT
con il valore dell'ID insight, specificato alla fine dell'URL dal camponame
per l'approfondimento.Il corpo della risposta include dettagli sul comportamento di GKE rilevato nel tuo cluster.
Visualizza l'elenco di suggerimenti per i cluster di una zona specifica (ad cluster di zona) o una regione specifica (per i cluster a livello di regione):
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.container.DiagnosisRecommender/recommendations?filter=recommenderSubtype%20%3D%20SUBTYPE
Sostituisci
SUBTYPE
con un sottotipo di motore per suggerimenti, ad esempioDEPRECATION_K8S_1_23_CERTIFICATE
. Questo limita l'output a suggerimenti di un sottotipo specificato. Questo flag è facoltativo.In alternativa, se disponi già di un ID consiglio, puoi visualizzare suggerimento presentando la seguente richiesta:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.container.DiagnosisRecommender/recommendations/RECOMMENDATION_ID
Sostituisci
RECOMMENDATION_ID
con il valore salvato diassociatedRecommendations.recommendation
dal corpo della risposta in Passaggio 1:Il corpo di risposta fornisce indicazioni sulle azioni che potresti dover intraprendere per ottimizzare l'utilizzo di GKE da parte del tuo cluster.
Esempio: Insight
Un insight sul ritiro include i dettagli sulle tempistiche e sulla quantità di utilizzo di funzionalità o API deprecate. Le informazioni incluse negli insight dipendono per quale tipo di ritiro viene fornito l'approfondimento informazioni.
Questo è un approfondimento di esempio per l'approfondimento DEPRECATION_K8S_1_22_V1BETA1_API
sottotipo:
name: projects/<PROJECT-NUMBER>/locations/us-central1/insightTypes/google.container.DiagnosisInsight/insights/<INSIGHT-ID>
observationPeriod: 2592000s
severity: HIGH
category: RELIABILITY
stateInfo:
state: ACTIVE
insightSubtype: DEPRECATION_K8S_1_22_V1BETA1_API
description: Your API clients have used deprecated APIs in the last 30 days that are removed in Kubernetes v1.22. Upgrading your cluster before migrating to the updated APIs supported by v1.22 could cause it to break. [Learn more](https://kubernetes.io/docs/reference/using-api/deprecation-guide/#v1-22).
targetResources:
- //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
associatedRecommendations:
- recommendation: projects/<PROJECT-NUMBER>/locations/us-central1/recommenders/google.container.DiagnosisRecommender/recommendations/<RECOMMENDATION-ID>
etag: '"2147dd8e1e302ed7"'
lastRefreshTime: "2022-01-30T08:00:00Z"
content:
targetClusters:
- clusterId: <CLUSTER-ID>
clusterUri: //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
apiDeprecationInsight:
- api: /apis/networking.k8s.io/v1beta1/Ingress
stopServingVersion: 1.22
deprecatedClientStats:
userAgent: kubectl
numberOfRequestsLast30Days: 288
lastRequestTime: "2022-02-30T08:00:18Z"
- api: /apis/rbac.authorization.k8s.io/v1beta1/ClusterRole
stopServingVersion: 1.22
deprecatedClientStats:
userAgent: kubectl
numberOfRequestsLast30Days: 126
lastRequestTime: "2022-02-01T06:45:25Z"
Esempio: consiglio
Un consiglio sul ritiro include una descrizione del ritiro con un link alla guida alla migrazione per il ritiro. Puoi trovare anche questi Guide alla migrazione nella tabella dei ritiri delle funzionalità di GKE e tabella di deprecazione dell'API Kubernetes.
Questo è un consiglio di esempio per DEPRECATION_K8S_1_22_V1BETA1_API
sottotipo di suggerimento:
name: projects/<PROJECT-NUMBER>/locations/us-central1/recommenders/google.container.DiagnosisRecommender/recommendations/<RECOMMENDATION-ID>
description: Update manifests and API clients to use v1 API before upgrading to Kubernetes 1.22 by following the [instructions](https://cloud.google.com/kubernetes-engine/docs/deprecations/apis-1-22).
primaryImpact:
category: RELIABILITY
reliabilityProjection:
risks:
- SERVICE_DISRUPTION
priority: P2
recommenderSubtype: DEPRECATION_K8S_1_22_V1BETA1_API
stateInfo:
state: ACTIVE
targetResources:
- //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
associatedInsights:
- insight: projects/<PROJECT-NUMBER>/locations/us-central1/insightTypes/google.container.DiagnosisInsight/insights/<INSIGHT-ID>
etag: '"4dc0f7b33594072f"'
lastRefreshTime: "2022-01-30T08:00:00Z"
content:
overview:
targetClusters:
- clusterId: <CLUSTER-ID>
clusterUri: //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
apiDeprecationRecommendation:
- api: /apis/networking.k8s.io/v1beta1/Ingress
apiReplacement: /apis/networking.k8s.io/v1/Ingress
stopServingVersion: 1.22
- api: /apis/rbac.authorization.k8s.io/v1beta1/ClusterRole
apiReplacement: /apis/rbac.authorization.k8s.io/v1/ClusterRole
stopServingVersion: 1.22
Esportazione di insight e suggerimenti in BigQuery
Puoi utilizzare BigQuery per esportare e analizzare insight e suggerimenti per l'intera organizzazione. Per saperne di più, vedi Esportare i suggerimenti in BigQuery.
Ignorare o ripristinare i consigli sul ritiro
Se non vuoi visualizzare un consiglio sul ritiro per un cluster nella nella console Google Cloud, ignoralo. Ad esempio, potresti per ignorare i suggerimenti che si applicano ai cluster temporanei di breve durata.
Se ignori il consiglio, questo non sarà visibile agli utenti che visualizzano cluster nella console. Dopo aver ignorato il consiglio, non apparirà più anche se uno user agent chiama l'API o la funzionalità deprecata in questo sottotipo.
Tuttavia, il suggerimento rimane rilevabile con Google Cloud CLI e l'API Recommender.
Quando ignori un consiglio, lo nascondi solo per tutti gli utenti. Automatica gli upgrade rimangono in pausa finché non esegui la migrazione dall'API o dalla funzionalità deprecata e GKE non rilevare l'utilizzo delle API deprecate per 30 giorni consecutivi o fino a quando la versione del cluster raggiunge la fine del supporto. Per saperne di più, vedi Quando GKE ripristina gli upgrade automatici?.
Ignorare un consiglio
Per ignorare il consiglio, segui le istruzioni per Visualizzazione di approfondimenti e consigli nella Console Google Cloud per aprire il riquadro della barra laterale, che contiene ulteriori dettagli. Nel riquadro, fai clic sul pulsante Ignora.
Ripristinare un suggerimento ignorato
Puoi ripristinare un suggerimento ignorato seguendo le istruzioni per Ripristinare un consiglio.
Passaggi successivi
- Per saperne di più su come funzionano i ritiri con GKE, consulta Ritiri di GKE.
- Per scoprire di più sull'API Recommender, consulta Utilizzo dell'API - Suggerimenti.