Cet article décrit les problèmes connus liés à Windows Admin Center pour AKS Arc. Vous pouvez également examiner les problèmes de mise à niveau et d’installation et les erreurs.
Des problèmes se sont produits lors de l’inscription de la passerelle Windows Admin Center auprès d’Azure
Si vous venez de créer un nouveau compte Azure et que vous ne vous êtes pas connecté au compte sur votre ordinateur passerelle, vous pouvez rencontrer des problèmes lors de l’inscription de votre passerelle Windows Admin Center auprès d’Azure.
Pour atténuer ce problème, connectez-vous à votre compte Azure dans un autre onglet ou fenêtre de navigateur, puis inscrivez la passerelle Windows Admin Center auprès d’Azure.
Seul l’utilisateur qui configure l’hôte AKS peut créer des clusters
Lors du déploiement d’Azure Kubernetes Service sur Azure Local via Windows Admin Center, seul l’utilisateur qui a configuré l’hôte AKS peut créer des clusters Kubernetes.
Pour contourner ce problème, copiez le dossier wssd du profil de l’utilisateur qui a configuré l’hôte Azure Kubernetes Service vers le profil de l’utilisateur qui créera les nouveaux clusters Kubernetes.
Récupération à partir d’un déploiement AKS ayant échoué sur Azure Local
Vous rencontrez des problèmes de déploiement ou souhaitez réinitialiser votre déploiement.
Fermez toutes les instances Windows Admin Center connectées à Azure Kubernetes Service sur Azure Local avant d’exécuter Uninstall-AksHci à partir d’une fenêtre d’administration PowerShell.
L’Assistant Configuration ou Création de cluster affiche une erreur concernant une configuration incorrecte
Vous pouvez recevoir une erreur dans l’un ou l’autre Assistant concernant une configuration incorrecte.
Effectuez des opérations de nettoyage de cluster. Ces opérations peuvent impliquer la suppression du fichier C :\Program Files\AksHci\mocctl.exe .
Les noms de champs de mise en réseau sont incohérents dans Windows Admin Center
Des incohérences sont à noter dans les noms de champs réseau apparaissant dans le processus de déploiement du cluster hôte et dans le processus de déploiement du cluster de charge de travail.
N/A
Sur Windows Admin Center, le message « erreur s’est produite lors de la création d’un principal de service » s’affiche lors de l’installation d’un hôte AKS sur Azure Local
Ce message d’erreur s’affiche si vous avez désactivé les fenêtres contextuelles. Google Chrome bloque les fenêtres contextuelles par défaut. Par conséquent, la fenêtre contextuelle de connexion Azure est bloquée et provoque l’erreur du principal de service.
Activez les fenêtres contextuelles.
Une erreur WinRM s’affiche lors de la création d’un cluster de charge de travail
Lors du passage du protocole DHCP vers une adresse IP statique, Windows Admin Center affiche une erreur indiquant que le client WinRM ne peut pas traiter la demande. Cette erreur s’est également produite en dehors de Windows Admin Center. WinRM s’arrête lors de l’utilisation d’adresses IP statiques, et les serveurs n’inscrivent pas de nom de principal de service (SPN) lors du déplacement vers des adresses IP statiques.
Pour résoudre ce problème, utilisez la commande setSPN pour créer le SPN. À partir d’une invite de commandes sur la passerelle Windows Admin Center, exécutez la commande suivante :
Setspn /Q WSMAN/<FQDN on the Azure Local machine>
Ensuite, si l’une des machines de l’environnement retourne le message No Such SPN Found
, connectez-vous à cet ordinateur et exécutez les commandes suivantes :
Setspn /S WSMAN/<machine name> <machine name>
Setspn /S WSMAN/<FQDN of machine> <machine name>
Enfin, sur la passerelle Windows Admin Center, exécutez ce qui suit pour vous assurer qu’elle obtient de nouvelles informations sur l’ordinateur à partir du contrôleur de domaine :
Klist purge
Notification de mise à niveau incorrecte dans Windows Admin Center
Si vous recevez un message de notification de mise à niveau incorrect « Réussite de l’installation de la version du module PowerShell AksHci null », l’opération de mise à niveau réussit même si la notification est trompeuse.
Vous pouvez ignorer ce message en toute sécurité.
L’accès est refusé
À l’étape 2.1 : Composant d’étape de base, vous pouvez rencontrer cette erreur : « Échec de la connexion au serveur distant *** avec le message d’erreur suivant : Access est refusé. Pour plus d’informations, consultez la rubrique d’aide about_Remote_Troubleshooting » lorsque vous essayez d’utiliser vos informations d’identification pour vos nœuds de serveur.
Assurez-vous que le compte/informations d’identification ajouté est un compte administratif sur l’ordinateur. Vérifiez ensuite que PSRemoting est activé et que les hôtes distants sont approuvés. Pour cela, vous pouvez utiliser les commandes PowerShell suivantes :
Enable-PSRemoting -Force
winrm quickconfig
Si vous rencontrez toujours des problèmes, consultez ce guide de résolution des problèmes.
Windows Admin Center n’a pas d’expérience de débardage Arc
Windows Admin Center ne dispose actuellement pas d’un processus pour désactiver un cluster à partir d’Azure Arc.
Pour supprimer des agents Arc sur un cluster qui a été détruit, accédez au groupe de ressources du cluster dans le Portail Azure et supprimez manuellement le contenu Arc. Pour supprimer des agents Arc sur un cluster qui est toujours en cours d’exécution, vous devez exécuter la commande suivante :
az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest
Remarque
Si vous utilisez le Portail Azure pour supprimer la ressource Kubernetes avec Arc, elle supprime toutes les ressources de configuration associées, mais ne supprime pas les agents en cours d’exécution sur le cluster. La meilleure pratique consiste à supprimer la ressource Kubernetes à l’aide az connectedk8s delete
de la Portail Azure.
Le tableau de bord de mise à jour de Windows Admin Center ne s’actualise pas après les mises à jour réussies
Après une mise à niveau réussie, le tableau de bord des mises à jour de Windows Admin Center affiche toujours la version précédente.
Actualisez le navigateur pour résoudre ce problème.
Résoudre les problèmes credSSP
Lorsque vous déployez AKS Arc à l’aide de Windows Admin Center et que le déploiement se bloque pendant une période prolongée, vous pouvez rencontrer des problèmes de connectivité ou de fournisseur de support de sécurité des informations d’identification (CredSSP).
Essayez de suivre les étapes suivantes pour résoudre votre déploiement :
Sur l’ordinateur exécutant Windows Admin Center, exécutez la commande suivante dans une fenêtre PowerShell :
Enter-PSSession <servername>
Si cette commande réussit, vous pouvez vous connecter au serveur et il n’y a pas de problème de connectivité.
Si vous rencontrez des problèmes avec CredSSP, exécutez cette commande pour tester l’approbation entre l’ordinateur passerelle et l’ordinateur cible :
Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSP
Vous pouvez également exécuter la commande suivante pour tester l’approbation d’accès à la passerelle locale :
Enter-PSSession -computer localhost -credential (Get-Credential)
Pour obtenir d’autres conseils de dépannage CredSSP, consultez Résoudre les problèmes CredSSP.
Une erreur de délai d’expiration s’affiche lors de la tentative de connexion d’un cluster de charge de travail AKS à Azure Arc via Windows Admin Center
Parfois, en raison de problèmes réseau, Windows Admin Center expire pendant une connexion Arc.
Utilisez la commande PowerShell Enable-AksHciArcConnection pour connecter le cluster de charge de travail AKS à Azure Arc pendant que nous travaillons activement à l’amélioration de l’expérience utilisateur.
'Install-Module' n’a pas été reconnu
À l’étape 2.1 : Validation du système, vous pouvez obtenir une erreur : « L’élément « Install-Module » n’a pas été reconnu comme nom d’une applet de commande, d’une fonction, d’un fichier de script ou d’un programme exécutable.
Vérifiez l’orthographe du nom. Si le chemin d’accès est inclus, vérifiez que le chemin est correct. Réessayez ensuite lorsque vous installez. Terminez les commandes PowerShell sur le ou les nœuds sur utilisant lequel vous essayez de déployer. Exécutez la commande suivante pour résoudre le problème (vérifiez que votre version de PowerShell est au moins 5.1) :
Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck
Exécutez ensuite ces commandes si vous rencontrez des erreurs avec la première commande :
Get-PSRepository
Register-PSRepository -Default
Impossible de connecter Windows Admin Center à Azure lors de la création d’un ID d’application Azure
Impossible de connecter Windows Admin Center à Azure, car vous ne pouvez pas créer et utiliser automatiquement un ID d’application Azure sur la passerelle.
Créez un ID d’application Azure et attribuez-lui les autorisations appropriées sur le portail. Ensuite, sélectionnez Use existing in the gateway (Utiliser l’existant dans la passerelle). Pour plus d’informations, visitez la connexion de votre passerelle à Azure.
Lors de la mise à jour de la version de Kubernetes, la page de mise à jour indique que la mise à jour est toujours en cours de traitement lorsque la mise à jour est terminée
Si vous avez des clusters de charges de travail sur lesquels Kubernetes version 1.19.9 est installé et que vous utilisez Windows Admin Center pour les mettre à jour vers Kubernetes version 1.19.11, la page de mise à jour de Kubernetes continue de montrer que la mise à jour est toujours en cours. Toutefois, si vous exécutez Get-AksHciCluster, la sortie montre que la mise à jour est terminée, et si vous ouvrez Windows Admin Center sous un nouvel onglet, le cluster est mis à jour avec la version 1.19.11 dans la liste des clusters Kubernetes.
Vous pouvez ignorer ce problème car le processus de mise à jour est bel et bien terminé.
Créer des journaux Windows Admin Center
Lorsque vous signalez des problèmes avec Windows Admin Center, il est judicieux de joindre des journaux pour aider l’équipe de développement à diagnostiquer votre problème. Les erreurs dans Windows Admin Center se présentent généralement sous l’une des deux formes suivantes :
- Événements affichés dans l’observateur d’événements sur l’ordinateur exécutant Windows Admin Center
- Problèmes JavaScript qui apparaissent dans la console du navigateur
Pour collecter les journaux de Windows Admin Center, utilisez le script Get-SMEUILogs.ps1
fourni dans le package en préversion publique.
Pour utiliser ce script, exécutez la commande suivante dans le dossier où votre script est stocké :
./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt
La commande comprend les paramètres suivants :
-ComputerNames
: liste des ordinateurs à partir duquel vous souhaitez collecter les journaux.-Destination
: machine à laquelle vous souhaitez agréger les journaux.-HoursAgo
: heure de début de la collecte des journaux, exprimée en heures avant l’exécution du script.-NoCredentialPrompt
: commutateur pour désactiver l’invite d’informations d’identification et utiliser les informations d’identification par défaut dans votre environnement actuel.
Si vous avez des difficultés à exécuter ce script, vous pouvez exécuter la commande suivante pour afficher le texte d’aide :
GetHelp .\Get-SMEUILogs.ps1 -Examples
L’exécution d’une mise à niveau entraîne l’erreur : « Une erreur s’est produite lors de l’extraction des informations de mise à niveau de la plateforme »
Lors de l’exécution d’une mise à niveau dans Windows Admin Center, l’erreur suivante s’est produite :
Error occurred while fetching platform upgrade information. RemoteException: No match was found for the specified search criteria and module name 'AksHci'. Try Get-PSRepository to see all available registered module repositories.
Ce message d’erreur se produit généralement lorsque AKS sur Azure Local est déployé dans un environnement sur lequel un proxy est configuré. Actuellement, Windows Admin Center ne prend pas en charge l’installation de modules dans un environnement proxy.
Pour résoudre cette erreur, configurez AKS sur Azure Local à l’aide de la commande PowerShell proxy.
Déploiement : Échec de la connexion au serveur distant localhost
Le déploiement du cluster hôte AKS échoue lors de la vérification du système avec une erreur du service WinRM.
Essayez d’appliquer les solutions suggérées dans la résolution manuelle des problèmes.
Lorsque plusieurs versions des modules PowerShell sont installées, Windows Admin Center ne choisit pas la dernière version
Si plusieurs versions des modules PowerShell sont installées (par exemple, 0.2.26, 0.2.27 et 0.2.28), Windows Admin Center peut ne pas utiliser la version la plus récente (ou celle dont il a besoin).
Assurez-vous qu’un seul module PowerShell est installé. Vous devez désinstaller toutes les versions PowerShell inutilisées des modules PowerShell et en conserver une seule installée. Pour plus d’informations sur la version de Windows Admin Center compatible avec la version de PowerShell, consultez les notes de publication AKS sur Azure Local.
Pendant le déploiement, l’erreur « Aucune correspondance n’a été trouvée pour les critères de recherche spécifiés pour le fournisseur **NuGet** » s’affiche.
Cette erreur s’affiche pendant le déploiement dans Windows Admin Center. Le fournisseur du package requiert les balises PackageManagement
et Provider
. Vous devez vérifier si le package spécifié a une erreur d’étiquette lors de la tentative de déploiement via Windows Admin Center.
Cette erreur provient de PowerShell et indique qu’il existe des problèmes de connectivité Internet. PowerShell tente d’installer le package requis et ne peut pas l’installer.
Vérifiez que le serveur ou le cluster de basculement dispose d’une connectivité Internet, puis démarrez une nouvelle installation.
À l’étape 2.1 : Validation du système, une erreur peut se produire lorsque vous accédez à l’installation : No match was found for the specified search criteria for the provider 'NuGet'. The package provider requires 'PackageManagement' and 'Provider' tags. Please check if the specified package has the tags.
terminez les commandes PowerShell sur le ou les nœuds sur utilisant lequel vous essayez de déployer. Vous devrez installer manuellement NuGet à l’aide de la commande PowerShell suivante :
Install-PackageProvider -Name NuGet -Scope CurrentUser -Force
Après avoir exécuté cette commande, fermez toutes les fenêtres PowerShell ouvertes et réessayez dans Windows Admin Center.
Impossible de trouver le dépôt « PSGallery »
À l’étape 2.1 : Validation du système, vous pouvez rencontrer cette erreur : « Impossible de trouver le référentiel « PSGallery ».
Utilisez Get-PSRepository pour afficher tous les référentiels disponibles. » lorsque vous cliquez sur Installer. Terminez les commandes PowerShell sur le ou les nœuds sur utilisant lequel vous essayez de déployer. Désinscrivez et réinscrivez le PSRepository dans une fenêtre PowerShell d’administration. Fermez ensuite toutes les fenêtres PowerShell.
Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default
Désinstallez et réinstallez Ensuite PowerShellGet dans une fenêtre PowerShell d’administration. Fermez ensuite toutes les fenêtres PowerShell.
Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force
Après cela, revenez à Windows Admin Center et réessayez.
Une erreur se produit lors de la tentative d’utilisation de Windows Admin Center
Si vous installez Windows Admin Center avec un compte et tentez de l’utiliser avec un autre, vous obtiendrez des erreurs.
Pour que CredSSP fonctionne correctement dans l’Assistant Création de cluster, Windows Admin Center doit être installé et utilisé par le même compte.
L’erreur « Impossible d’indexer dans un tableau Null » s’affiche lors de la création d’un cluster de charge de travail avec Arc
Cette erreur s’affiche lors du passage de PowerShell à Windows Admin Center pour créer un cluster de charge de travail avec Arc.
Vous pouvez ignorer cette erreur sans risque. Il fait partie de l’étape de validation et le cluster a déjà été créé.
Le redémarrage des nœuds locaux Azure provoque un problème de minutage
Le redémarrage des nœuds de cluster local Azure hébergeant le cluster de gestion et les clusters de charge de travail peut entraîner la disparition des clusters de charge de travail dans le tableau de bord windows Admin Center.
Pour contourner ce problème, suspendez l’exécution des nœuds et nettoyez-les avant de planifier les redémarrages. Parfois, les clusters de charge de travail peuvent simplement prendre plus de temps à apparaître dans le tableau de bord.
Impossible de déployer AKS dans un environnement qui a des clusters de stockage et de calcul distincts
Windows Admin Center ne déploiera pas Azure Kubernetes Service dans un environnement avec des clusters de stockage et de calcul distincts, car il s’attend à ce que les ressources de calcul et de stockage soient fournies par le même cluster. Dans la plupart des cas, il ne trouve pas les CSV exposés par le cluster de calcul et refuse de poursuivre le déploiement.
Étapes suivantes
- Vue d’ensemble de la résolution des problèmes
- Problèmes et erreurs d’installation
- Problèmes connus avec la mise à niveau
Si vous continuez à rencontrer des problèmes lorsque vous utilisez AKS Arc, vous pouvez enregistrer des bogues via GitHub.