Risoluzione dei problemi di aggiornamento secondario dell'aggiornamento delle revisioni di Istio Service Mesh

Articolo
11/20/2024

Questo articolo illustra gli scenari di risoluzione dei problemi e le restrizioni nei processi di aggiornamento e rollback delle revisioni secondari per il componente aggiuntivo Mesh del servizio Istio in Microsoft servizio Azure Kubernetes (servizio Azure Kubernetes).

Note

Istio usa il termine "revisioni" per implementare il processo di aggiornamento canary e distinguere tra le versioni. Ogni designazione di revisione (scritta come x-y) corrisponde a una designazione di versione principale.secondaria (x.y). È possibile controllare la revisione del piano di controllo, ma non è possibile controllare la versione della patch specifica all'interno di una banda di revisione.

Prerequisiti

Interfaccia della riga di comando di Azure.
Lo strumento Kubernetes kubectl o uno strumento simile per connettersi al cluster. Per installare kubectl usando l'interfaccia della riga di comando di Azure, eseguire il comando az aks install-cli .

Matrice di risoluzione dei problemi

Nella tabella seguente sono elencati i vari problemi e i diversi scenari e soluzioni per tali problemi.

Scenario	Problema	Soluzione
I carichi di lavoro del piano dati vengono eliminati dalla mesh.	Le revisioni del piano dati e del piano di controllo non corrispondono prima del completamento o del rollback di un aggiornamento.	Seguire questa procedura: Etichettare nuovamente gli spazi dei nomi che contengono carichi di lavoro specificando la revisione prevista dopo il completamento dell'aggiornamento o il rollback. A tale scopo, eseguire il comando kubectl label : kubectl label namespace default istio.io/rev=asm-x-y --overwrite Riavviare le distribuzioni del carico di lavoro corrispondenti per attivare la reiniezione sidecar della revisione corretta. A tale scopo, eseguire il comando kubectl rollout restart : kubectl rollout restart deployment <deployment name> Verificare che le immagini sidecar esistano. A tale scopo, eseguire il comando kubectl get : kubectl get pods --namespace <namespace> --output yaml \| grep mcr.microsoft.com/oss/istio/proxyv2:
I pod del piano di controllo si trovano nello stato in sospeso.	I pod non hanno capacità.	Verificare lo stato dei pod eseguendo il comando kubectl describe . Se la capacità è il problema, è possibile aumentare le prestazioni del cluster per aggiungere un altro nodo. Per altre informazioni, vedere Ridimensionare manualmente il numero di nodi in un cluster del servizio Azure Kubernetes (servizio Azure Kubernetes).
Il comando az aks mesh get-upgrades non restituisce aggiornamenti disponibili.	La revisione Istio più recente potrebbe non essere compatibile con la versione corrente del cluster del servizio Azure Kubernetes.	È possibile usare il comando az aks mesh get-revisions per individuare se esistono revisioni Istio più recenti. L'output include un elenco di versioni del cluster compatibili per ogni revisione istio. Pertanto, è possibile determinare se è necessario un aggiornamento del cluster.

Scenario

Problema

Soluzione

I carichi di lavoro del piano dati vengono eliminati dalla mesh.

Le revisioni del piano dati e del piano di controllo non corrispondono prima del completamento o del rollback di un aggiornamento.

Seguire questa procedura:

Etichettare nuovamente gli spazi dei nomi che contengono carichi di lavoro specificando la revisione prevista dopo il completamento dell'aggiornamento o il rollback. A tale scopo, eseguire il comando kubectl label :
```
kubectl label namespace default istio.io/rev=asm-x-y --overwrite
```
Riavviare le distribuzioni del carico di lavoro corrispondenti per attivare la reiniezione sidecar della revisione corretta. A tale scopo, eseguire il comando kubectl rollout restart :
```
kubectl rollout restart deployment <deployment name>
```

Verificare che le immagini sidecar esistano. A tale scopo, eseguire il comando kubectl get :

kubectl get pods --namespace <namespace> --output yaml | grep mcr.microsoft.com/oss/istio/proxyv2:

I pod del piano di controllo si trovano nello stato in sospeso.

I pod non hanno capacità.

Verificare lo stato dei pod eseguendo il comando kubectl describe . Se la capacità è il problema, è possibile aumentare le prestazioni del cluster per aggiungere un altro nodo. Per altre informazioni, vedere Ridimensionare manualmente il numero di nodi in un cluster del servizio Azure Kubernetes (servizio Azure Kubernetes).

Il comando az aks mesh get-upgrades non restituisce aggiornamenti disponibili.

La revisione Istio più recente potrebbe non essere compatibile con la versione corrente del cluster del servizio Azure Kubernetes.

È possibile usare il comando az aks mesh get-revisions per individuare se esistono revisioni Istio più recenti. L'output include un elenco di versioni del cluster compatibili per ogni revisione istio. Pertanto, è possibile determinare se è necessario un aggiornamento del cluster.

Note

Per evitare comportamenti imprevisti e funzionalità interrotte e assicurarsi anche di ricevere aggiornamenti per le vulnerabilità di sicurezza, è consigliabile eseguire l'aggiornamento a una versione del servizio Azure Kubernetes supportata e aggiornata e alla revisione del componente aggiuntivo Istio. Tenere presente che la revisione del componente aggiuntivo deve essere inclusa anche nell'intervallo di versioni di Kubernetes supportato per il cluster del servizio Azure Kubernetes specificato. Come evidenziato nella sezione Aggiornamento di revisione secondaria dell'articolo Aggiornamento istio, è possibile eseguire i az aks mesh get-revisions comandi e az aks mesh get-upgrades per informazioni sulle revisioni, gli aggiornamenti e le informazioni sulla compatibilità disponibili.

Restrizioni

Non è consentito eseguire il downgrade a una revisione precedente (all'esterno del processo di rollback canary).
È consentito ignorare da una revisione a una revisione non vincolata solo se il servizio Azure Kubernetes non supporta più sia la revisione corrente che la revisione successiva dell'aggiornamento. A questo punto, l'unico aggiornamento disponibile per l'utente è la revisione supportata più bassa.
L'etichetta Istio non abilita l'inserimento sidecar.istio.io/inject sidecar per il componente aggiuntivo Istio. È necessario usare l'etichetta istio.io/rev quando si etichettano e si etichettano nuovamente gli spazi dei nomi durante l'aggiornamento canary.
L'etichettatura deve essere eseguita a livello di spazio dei nomi anziché a livello di distribuzione. Se si vuole essere in grado di eseguire il rollover dei pod singolarmente, è possibile scegliere di riavviare le singole distribuzioni invece di usare l'etichettatura dei pod.
Se si usa il componente aggiuntivo Istio Shared MeshConfig, è necessario copiare o trasferire le impostazioni meshConfig nel nuovo ConfigMap prima di eseguire un aggiornamento canary. Per altre informazioni, vedere Configurazione e aggiornamenti di Mesh.
Il componente aggiuntivo Istio distribuisce i pod e le distribuzioni del gateway in ingresso Istio per revisione. Se si esegue un aggiornamento canary e sono installate due revisioni del piano di controllo nel cluster, potrebbe essere necessario risolvere i problemi relativi a più pod gateway in ingresso in entrambe le revisioni.

Riferimenti

Dichiarazione di non responsabilità sulle informazioni di terze parti

I prodotti di terzi citati in questo articolo sono prodotti da società indipendenti da Microsoft. Microsoft non rilascia alcuna garanzia implicita o esplicita relativa alle prestazioni o all'affidabilità di tali prodotti

Dichiarazione di non responsabilità di contatti di terze parti

Microsoft fornisce informazioni di contatto di terze parti per aiutarti a trovare ulteriori informazioni su questo argomento. Queste informazioni di contatto sono soggette a modifica senza preavviso. Microsoft non garantisce l'accuratezza delle informazioni di contatto di terze parti.

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.

Condividi tramite