Cet article décrit les problèmes connus liés à Windows Admin Center pour AKS Arc. Vous pouvez également passer en revue les problèmes et erreurs de mise à niveau et d’installation.
Problèmes survenus 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 a configuré l’hôte AKS peut créer des clusters
Lors du déploiement d’Azure Kubernetes Service sur Azure Stack HCI 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 échec d’AKS sur un déploiement Azure Stack HCI
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 Stack HCI avant d’exécuter Uninstall-AksHci à partir d’une fenêtre d’administration PowerShell.
L’Assistant Installation ou Création d’un cluster affiche une erreur de configuration incorrecte
Vous pouvez recevoir une erreur dans l’un des assistants concernant une configuration incorrecte.
Effectuer des opérations de nettoyage de cluster. Ces opérations peuvent impliquer la suppression du fichier de Files\AksHci\mocctl.exeC :\Program .
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 du principal de service » s’affiche lors de l’installation d’un hôte AKS sur Azure Stack HCI
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 Stack HCI Server>
Ensuite, si l’un des serveurs de l’environnement retourne le message No Such SPN Found
, connectez-vous à ce serveur et exécutez les commandes suivantes :
Setspn /S WSMAN/<server name> <server name>
Setspn /S WSMAN/<FQDN of server> <server name>
Enfin, sur la passerelle Windows Admin Center, exécutez la commande suivante pour vous assurer qu’elle reçoit du contrôleur de domaine les informations sur le nouveau serveur :
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 du module AksHci PowerShell version 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 l’erreur suivante : « La connexion au serveur distant *** a échoué avec le message d’erreur suivant : Accès 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/les informations d’identification ajoutés sont un compte d’administration 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 pas actuellement d’un processus pour désactiver un cluster 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, puis 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
Notes
Si vous utilisez la 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 en utilisant az connectedk8s delete
au lieu de la Portail Azure.
Le tableau de bord des mises à jour de Windows Admin Center n’est pas actualisé après des 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 des problèmes liés à 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 fournisseur de support de sécurité des informations d’identification (CredSSP) ou de connectivité.
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 d’expiration de délai d’attente s’affiche lors de la tentative de connexion d’un cluster de charge de travail AKS à Azure Arc par le biais de 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, assurez-vous qu’il est correct. Réessayez ensuite lors de l’installation. Terminez les commandes PowerShell sur le ou les nœuds sur lesquels 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 Azure Application
Impossible de se connecter Windows Admin Center à Azure, car vous ne pouvez pas créer et utiliser automatiquement un ID de Azure App sur la passerelle.
Créez un ID Azure App 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, consultez Connexion de votre passerelle à Azure.
Lors de la mise à jour de la version Kubernetes, la page de mise à jour montre que la mise à jour est toujours en cours alors qu’elle 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 desquels vous souhaitez collecter les journaux. -
-Destination
: Ordinateur sur lequel vous voulez agréger les journaux. -
-HoursAgo
: Heure de début de la collecte des journaux, exprimée en heures précédant l’exécution du script. -
-NoCredentialPrompt
: Commutateur permettant de désactiver l’invite de saisie d’informations d’identification et permettant d’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 génère 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 Stack HCI est déployé dans un environnement pour 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 Stack HCI à l’aide de la commande PowerShell de 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. Plus d’informations sur la version de Windows Admin Center qui est compatible avec la version de PowerShell sont disponibles dans les notes de publication d’AKS sur Azure Stack HCI.
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 case activée si le package spécifié présente une erreur de balise 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 des prérequis et ne parvient 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 lesquels 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.
Dépôt « PSGallery » introuvable
À l’étape 2.1 : Validation du système, vous pouvez rencontrer l’erreur suivante : « Impossible de trouver le dépôt « PSGallery ».
Utilisez Get-PSRepository pour afficher tous les dépôts disponibles. » lorsque vous cliquez sur Installer. Effectuez les commandes PowerShell sur le ou les nœuds sur lesquels vous essayez de déployer. Désinscrivez et réinscrivez le PSRepository dans une fenêtre PowerShell administrative. Fermez ensuite toutes les fenêtres PowerShell.
Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default
Ensuite, désinstallez et réinstallez 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 d’une tentative d’utiliser 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 Azure Stack HCI provoque un problème de synchronisation
Le redémarrage des nœuds de cluster Azure Stack HCI hébergeant le cluster de gestion et les clusters de charge de travail peut entraîner la disparition des clusters de charge de travail du 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 disposant de 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 rencontrez toujours des problèmes lorsque vous utilisez AKS Arc, vous pouvez enregistrer des bogues via GitHub.