Partager via

Guide de résolution des problèmes dans AKS activé par Azure Arc sur VMware

  • Article

S’applique à : AKS activé par Azure Arc sur VMware (préversion)

Cet article décrit les étapes de résolution des problèmes connus et des erreurs qui peuvent se produire lors du déploiement d’AKS activé par Azure Arc sur VMware (préversion). Vous pouvez également consulter les problèmes connus ici ou suivre la vue d’ensemble de la résolution des problèmes pour signaler des bogues ou fournir des commentaires sur le produit.

Cette page est continuellement mise à jour. Consultez cette page pour obtenir de nouvelles informations. Comme nous identifions les problèmes critiques qui nécessitent des solutions de contournement, nous les ajoutons. Passez en revue ces informations attentivement avant de déployer votre instance AKS Arc sur VMware en préversion.

Pont de ressources Arc

Problèmes de pont de ressources Azure Arc

Pour connaître les problèmes de pont de ressources Azure Arc, consultez le guide de résolution des problèmes ici.

Récupérer à partir des déploiements ayant échoué de Arc Resource Bridge

Consultez le guide de résolution des problèmes ici.

Connexion vCenter à Azure

S’il existe un message d’erreur indiquant « Le nom> du pont de ressources de pont <de ressources associé à ce vCenter n’est actuellement pas disponible. Les opérations effectuées sur ce vCenter peuvent échouer en conséquence », indique que le pont de ressources utilisé pour connecter le vCenter est arrêté ou supprimé.

Pour résoudre ce problème, procédez comme suit :

Collecter les journaux d’activité

Si vous rencontrez des problèmes, vous pouvez partager les fichiers journaux et la version cli avec les ingénieurs du support technique à des fins de débogage.

Problèmes avant le déploiement de Arc Resource Bridge

Récupérez le fichier kva.log à partir du système à l’adresse c :\programdata\kva\kva.log pour plus d’informations détaillées.

Problèmes lors du déploiement d’Arc Resource Bridge

Pour collecter les journaux, exécutez les commandes suivantes à partir de la machine que vous avez précédemment utilisée pour tenter le déploiement du pont de ressources Arc. À compter de l’interface CLI version 1.0.0, vous devez d’abord exécuter la commande az arcappliance get-credentials. Cela garantit que toutes les informations d’identification requises pour la collecte de journaux sont extraites sur l’ordinateur. Pour plus d’informations sur cette commande, consultez la documentation CLI :

az arcappliance get-credentials –name <name of Arc Resource Bridge> --resource-group <name of resource group>

Après avoir exécuté la commande, vous pouvez poursuivre la az arcappliance get-credentials collecte de journaux à l’aide de la az arcappliance logs vmware commande :

az arcappliance logs vmware --ip <Arc Resource Bridge VM control plane IP endpoint> --address <vCenter FQDN/IP address, same one used when creating config files> --username <vcenter username> --password <vcenter password>

Si vous n’avez pas encore créé de machine virtuelle d’appliance, la az arcappliance logs vmware commande n’est pas utile et le fichier de clé journal n’est pas généré.

Problèmes liés à Arc Resource Bridge en cours d’exécution

Pour collecter les journaux, exécutez la az arcappliance logs vmware commande à partir de la même machine que celle que vous avez utilisée pour déployer Arc Resource Bridge :

  • Si vous disposez de kubeconfig pour votre appliance et que la machine virtuelle de l’appliance s’exécute avec un serveur d’API accessible, la commande suivante collecte les journaux à partir de l’appliance et génère un fichier .zip dans le répertoire de travail actuel :

    az arcappliance logs vmware --kubeconfig='<path to your kubeconfig>'

  • Si vous n’avez pas kubeconfig ou que votre serveur d’API n’est pas accessible, la commande suivante collecte les journaux à l’aide de l’adresse IP de la machine virtuelle de l’appliance spécifiée (vérifiez votre infrastructure de virtualisation, par exemple, le gestionnaire Hyper-V, pour localiser l’adresse IP de la machine virtuelle de l’appliance). Notez que le kubeconfig paramètre est toujours requis, mais qu’il peut être passé en tant que chaîne vide si une adresse IP est également fournie :

    az arcappliance logs vmware --kubeconfig='' --ip='<IP address of Arc Resource Bridge VM>'

Exemples avec des valeurs remplies

az arcappliance logs vmware --kubeconfig .\resourcebridge\kubeconfig
az arcappliance logs vmware --kubeconfig='kubeconfig'
az arcappliance logs vmware --kubeconfig='' --ip=10.0.1.166

Obtenir la version de l’extension CLI

Vous pouvez retourner la version de l’extension CLI de l’appliance en exécutant la commande suivante :

az extension show --name arcappliance -o table

Vous devez disposer d’une version récente d’Az CLI installée sur tous les nœuds de votre cluster physique.

  • Vérifiez que vous disposez d’Az CLI en exécutant az -v.
  • Effectuez une mise à niveau vers la dernière version en exécutant az upgrade.

Messages d’erreur et étapes de résolution des problèmes

Cette section fournit la liste des messages d’erreur courants et leurs étapes de résolution des problèmes.

Erreur : « AlreadyDeployedError »

  • Cause racine : cette erreur se produit, car l’environnement n’a pas été nettoyé à partir du déploiement précédent avant de tenter de déployer à nouveau.
  • Résolution : pour résoudre ce problème, désinstallez Arc Resource Bridge, puis réessayez de déployer.

Erreur : x509 : le certificat a expiré ou n’est pas encore valide : l’heure actuelle1 est antérieure à <l’heure2<>.> Échec de la vérification

  • Cause racine : cette erreur se produit lorsque les certificats expirent en raison d’une incompatibilité de temps entre la machine cliente et la machine virtuelle (ou le serveur ESXi). L’un d’eux n’est pas compatible NTP.
  • Résolution :
    1. Vérifiez si l’heure sur la machine virtuelle correspond à l’heure sur la machine que vous avez utilisée pour le déploiement ARB.
    2. Connectez le serveur ESXi à un serveur NTP pour synchroniser son temps et résoudre le problème.

Erreur : le terme « az » n’est pas reconnu comme nom d’une applet de commande, d’une fonction, d’un fichier de script ou d’un programme opérable. Vérifiez l’orthographe du nom, ou si un chemin d’accès a été inclus, vérifiez que le chemin est correct et réessayez

  • Cause racine : Az CLI n’est pas reconnu, car la fenêtre PowerShell précédente a été fermée et n’a pas été synchronisée avec l’installation d’Azure CLI.
  • Résolution :
    1. Ouvrez une nouvelle fenêtre PowerShell et accédez au dossier dans lequel vous avez stocké le script d’intégration Arc Resource Bridge.
    2. Exécutez .temp\.env\Scripts\Activate.ps1 pour installer Python venv.

Étapes suivantes