Résoudre les problèmes courants dans AKS Edge Essentials

Article
12/18/2024

Cet article explique comment trouver des solutions aux problèmes rencontrés lors de l’utilisation d’AKS Edge Essentials. Les problèmes connus et les erreurs sont organisés par zone fonctionnelle. Vous pouvez utiliser les liens fournis dans cet article pour trouver des solutions et des solutions de contournement pour les résoudre.

Ouverture d’une demande de support

Pour plus d’informations sur l’utilisation de l’Portail Azure pour obtenir du support ou ouvrir une demande de support pour AKS Edge Essentials, consultez l’article Obtenir du support technique.

Problèmes de déploiement

Problème d’éditeur non approuvé

Message d’erreur : « Voulez-vous exécuter des logiciels à partir de cet éditeur non approuvé ? ....."

Solution de contournement : Mettez à jour votre stratégie d’exécution PowerShell vers 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 }

L’espace disque faible entraîne la suppression d’images conteneur précédemment mises en cache

Lorsque le nœud manque d’espace disque, certaines des images préchargées sont collectées par le containerd runtime. Dans ce cas, libérez tout d’abord un espace disque, puis exécutez la commande suivante pour extraire à nouveau les images mises en cache :

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

Ce script vérifie les images manquantes et les réimporte si nécessaire.

Connectivité Azure Arc

Problème : Disconnect-AksEdgeArc ne supprime pas les pods du cluster.

Solution de contournement : si les pods ne sont pas nettoyés, exécutez les commandes suivantes pour nettoyer manuellement les ressources azure Arc existantes avant de réessayer :
```
kubectl delete ns azure-arc
kubectl delete clusterrolebinding azure-arc-operator
kubectl delete secret sh.helm.release.v1.azure-arc.v1
```
Problème : la connectivité Azure Arc ne fonctionne pas dans un environnement proxy.

Solution de contournement : vous pouvez activer les paramètres de proxy à l’échelle du système en suivant les options > Internet Connexions > LAN Settings.

Impossible de supprimer complètement le cluster AKS Arc avec des ressources PodDisruptionBudget (PDB)

Pour plus d’informations sur ce problème connu, consultez Impossible de supprimer complètement le cluster AKS Arc avec des ressources PDB dans la documentation AKS Arc.

Déploiements hors connexion

Échec de l’obtention du certificat nodeagent : introuvable

Vérifiez la configuration de la carte réseau. Pendant le déploiement, AKS Edge Essentials a besoin d’un adaptateur activé et a l’adresse IP, le sous-réseau et la passerelle par défaut appropriés. Ces valeurs sont automatiquement remplies dans un environnement DHCP. Si vous définissez manuellement, vérifiez que les trois sont définis. Dans de nombreux cas, la passerelle par défaut n’est pas définie, ce qui entraîne cette erreur.

Kubernetes

Le pod Kube-vip redémarre en continu

Dans certains scénarios, les boucles de pod kube-vip et redémarrent en continu.

Validation

Pour confirmer que le scénario que vous rencontrez est le même problème documenté dans cet article, vérifiez que le pod kube-vip dans l’espace de noms kube-system a un nombre élevé de redémarrages en exécutant la commande suivante :

kubectl get pods –n kube-system

Cause

Il existe plusieurs raisons pour lesquelles le pod kube-vip peut être en permanence redémarré. Ces causes sont les suivantes :

Utilisation d’un disque de système d’exploitation qui n’est pas sauvegardé avec un disque SSD ou un disque SSD Premium lors de l’utilisation d’une machine virtuelle Azure. Vous pouvez passer en revue la configuration matérielle requise ici.
La latence du disque est trop élevée. Si la latence du disque est supérieure à 10 ms, elle peut entraîner des délais d’expiration des demandes, une perte de leader et une instabilité potentielle du cluster. Vous pouvez consulter la configuration matérielle requise pour etcd ici.

Résolution

Pour atténuer ce problème, passez en revue votre infrastructure de stockage sous-jacente pour vous assurer qu’elle répond aux exigences de performances pour etcd et AKS Edge Essentials. Envisagez également d’utiliser le stockage ssd Premium ou d’optimiser votre configuration de stockage pour les performances.

Étapes suivantes

Vue d’ensemble d’AKS Edge Essentials

Partager via