Risolvere i problemi comuni in Azure Kubernetes Edge Essentials

Articolo
07/23/2024

Questo articolo descrive come trovare soluzioni per i problemi riscontrati quando si usa AKS Edge Essentials. I problemi noti e gli errori sono organizzati in base all'area funzionale. È possibile usare i collegamenti forniti in questo articolo per trovare soluzioni e soluzioni alternative per risolverli.

Aprire una richiesta di supporto

Vedere l'articolo Ottenere supporto per informazioni su come usare il portale di Azure per ottenere supporto o aprire una richiesta di supporto per Azure Kubernetes Edge Essentials.

Problemi di distribuzione

Problema relativo all'autore non attendibile

Messaggio di errore: "Eseguire il software da questo editore non attendibile? ....."

Soluzione alternativa: aggiornare i criteri di esecuzione di PowerShell a RemoteSigned:

# Get the execution policy on the system
Get-ExecutionPolicy
# Set the execution policy for this process only
if ((Get-ExecutionPolicy) -ne "RemoteSigned") { Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force }

Lo spazio su disco insufficiente causa l'eliminazione delle immagini del contenitore memorizzate nella cache

Quando il nodo esaurisce lo spazio su disco, alcune delle immagini pre caricate vengono eseguite tramite garbage collection dal containerd runtime. In questo caso, liberare prima di tutto spazio su disco e quindi eseguire il comando seguente per eseguire di nuovo il pull delle immagini memorizzate nella cache:

    Invoke-AksEdgeNodeCommand -NodeType Linux -command "sudo /path/to/script/reimport-ci.sh

Questo script verifica la presenza di immagini mancanti e le reimporta in base alle esigenze.

Connettività di Azure Arc

Problema: Disconnect-AksEdgeArc non rimuove i pod dal cluster.

Soluzione alternativa: se i pod non vengono puliti, eseguire i comandi seguenti per pulire manualmente le risorse correlate ad Azure Arc esistenti prima di tentare di riconnettersi:
```
kubectl delete ns azure-arc
kubectl delete clusterrolebinding azure-arc-operator
kubectl delete secret sh.helm.release.v1.azure-arc.v1
```
Problema: la connettività di Azure Arc non funziona in un ambiente proxy.

Soluzione alternativa: è possibile abilitare le impostazioni proxy a livello di sistema seguendo le opzioni > Internet Connessioni > LAN Impostazioni.

Distribuzioni offline

Impossibile ottenere il certificato nodeagent: Non trovato

Controllare la configurazione della scheda di rete. Durante la distribuzione, AKS Edge Essentials necessita di una scheda abilitata e con l'indirizzo IP, la subnet e il gateway predefinito corretti. Questi valori vengono popolati automaticamente in un ambiente DHCP. Se si imposta manualmente, assicurarsi che tutte e tre le impostazioni siano impostate. In molti casi, il gateway predefinito non è impostato, che genera questo errore.

Kubernetes

Il pod Kube-vip viene riavviato continuamente

In alcuni scenari, il pod kube-vip esegue cicli e riavvia continuamente.

Convalida

Per verificare che lo scenario riscontrato sia lo stesso problema documentato in questo articolo, verificare che il pod kube-vip nello spazio dei nomi kube-system abbia un numero elevato di riavvii eseguendo il comando seguente:

kubectl get pods –n kube-system

Causa

Esistono diversi motivi per cui il pod kube-vip potrebbe essere continuamente riavviato. Queste cause includono:

Uso di un disco del sistema operativo non supportato con un disco SSD o un disco SSD Premium quando si usa una macchina virtuale di Azure. È possibile esaminare i requisiti hardware qui.
La latenza del disco è troppo elevata. Se la latenza del disco è maggiore di 10 ms, può comportare timeout delle richieste, perdita di leader e potenziale instabilità del cluster. È possibile esaminare i requisiti hardware per etcd qui.

Risoluzione

Per attenuare questo problema, esaminare l'infrastruttura di archiviazione sottostante per assicurarsi che soddisfi i requisiti di prestazioni per etcd e AKS Edge Essentials. Prendere in considerazione anche l'uso dell'archiviazione basata su SSD Premium o l'ottimizzazione della configurazione di archiviazione per le prestazioni.

Passaggi successivi

Panoramica di Azure Kubernetes Edge Essentials

Condividi tramite