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 en préversion. Vous pouvez également passer en revue 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 les produits.

Cette page étant constamment mise à jour, case activée ici pour obtenir de nouvelles informations. Lorsque nous identifions les problèmes critiques qui nécessitent des solutions de contournement, nous les ajoutons. Consultez attentivement ces informations avant de déployer votre version préliminaire d’AKS Arc sur VMware.

Pont de ressources Arc

Problèmes liés au pont de ressources Azure Arc

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

Récupérer après des déploiements ayant échoué d’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 », cela indique que le pont de ressources utilisé pour connecter le vCenter est arrêté ou supprimé.

Pour résoudre ce problème, effectuez les étapes suivantes :

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 d’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 pendant le déploiement d’Arc Resource Bridge

Pour collecter les journaux, exécutez les commandes suivantes à partir de l’ordinateur que vous avez utilisé précédemment 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 az arcappliance get-credentials commande, vous pouvez continuer la collecte des 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 Appliance, la az arcappliance logs vmware commande n’est pas utile et le fichier de clé de journal n’est pas généré.

Problèmes lors de l’exécution d’Arc Resource Bridge

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 du kubeconfig pour votre Appliance et que la machine virtuelle Appliance s’exécute avec un serveur d’API accessible, la commande suivante collecte les journaux à partir du Appliance et génère un fichier .zip dans le répertoire de travail actif :

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

  • Si vous n’avez pas kubeconfig ou si votre serveur d’API est inaccessible, la commande suivante collecte les journaux à l’aide de l’adresse IP de machine virtuelle spécifiée Appliance (case activée votre infrastructure de virtualisation, par exemple, le gestionnaire Hyper-V, pour localiser l’adresse IP de la machine virtuelle Appliance). Notez que le kubeconfig paramètre est toujours obligatoire, mais peut être passé sous forme de 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 Appliance en exécutant la commande suivante :

az extension show --name arcappliance -o table

Une version récente d’Az CLI doit être installée sur tous les nœuds de votre cluster physique.

  • Vérifiez que vous avez 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 une liste des messages d’erreur courants et leurs étapes de résolution des problèmes.

Erreur : « AlreadyDeployedError »

  • Cause racine : cette erreur se produit parce que l’environnement n’a pas été nettoyé du déploiement précédent avant de tenter de redéployer.
  • 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 l’ordinateur client et la machine virtuelle (ou le serveur ESXi). L’un d’eux n’est pas activé par 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 heure 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 d’Arc Resource Bridge.
    2. Exécutez .temp\.env\Scripts\Activate.ps1 pour installer Python venv.

Étapes suivantes