Este artigo descreve problemas conhecidos com Windows Admin Center para o AKS Arc. Também pode rever problemas e erros de atualização e instalação.
Ocorreram problemas ao registar o gateway de Windows Admin Center no Azure
Se acabou de criar uma nova conta do Azure e ainda não iniciou sessão na conta no computador gateway, poderá ter problemas ao registar o gateway de Windows Admin Center no Azure.
Para mitigar este problema, inicie sessão na sua conta do Azure noutro separador ou janela do browser e, em seguida, registe o gateway de Windows Admin Center no Azure.
Apenas o utilizador que configurou o anfitrião do AKS pode criar clusters
Ao implementar Azure Kubernetes Service no Azure Stack HCI através de Windows Admin Center, apenas o utilizador que configurou o anfitrião do AKS pode criar clusters do Kubernetes.
Para resolver este problema, copie a pasta wssd do perfil do utilizador que configurou o anfitrião do AKS para o perfil do utilizador que irá criar os novos clusters do Kubernetes.
Recuperar a partir de uma implementação do AKS falhada no Azure Stack HCI
Está a ter problemas de implementação ou quer repor a implementação.
Feche todas as Windows Admin Center instâncias ligadas a Azure Kubernetes Service no Azure Stack HCI antes de executar Uninstall-AksHci a partir de uma janela administrativa do PowerShell.
O assistente de Configuração ou Criação de Clusters apresenta um erro sobre uma configuração errada
Pode receber um erro em qualquer um dos assistentes sobre uma configuração errada.
Executar operações de limpeza do cluster. Estas operações podem envolver a remoção do ficheiro C:\Program Files\AksHci\mocctl.exe .
Os nomes dos campos de rede são inconsistentes no Windows Admin Center
Existem inconsistências nos nomes dos campos de rede que aparecem no fluxo de implementação do cluster anfitrião e no fluxo de implementação do cluster de cargas de trabalho.
N/D
No Windows Admin Center, é apresentada a mensagem "ocorreu um erro ao criar o principal de serviço" ao instalar um anfitrião do AKS no Azure Stack HCI
Receberá este erro se tiver desativado pop-ups. O Google Chrome bloqueia pop-ups por predefinição e, por conseguinte, o pop-up de início de sessão do Azure está bloqueado e causa o erro do principal de serviço.
Ativar pop-ups.
É apresentado um erro winRM ao criar um novo cluster de cargas de trabalho
Ao mudar de DHCP para IP estático, Windows Admin Center apresentado um erro que dizia que o cliente WinRM não consegue processar o pedido. Este erro também ocorreu fora do Windows Admin Center. O WinRM foi quebrado quando foram utilizados endereços IP estáticos e os servidores não estavam a registar um Nome principal de serviço (SPN) ao moverem-se para endereços IP estáticos.
Para resolver este problema, utilize o comando SetSPN para criar o SPN. A partir de uma linha de comandos no gateway de Windows Admin Center, execute o seguinte comando:
Setspn /Q WSMAN/<FQDN on the Azure Stack HCI Server>
Em seguida, se algum dos servidores no ambiente devolver a mensagem No Such SPN Found, inicie sessão nesse servidor e execute os seguintes comandos:
Setspn /S WSMAN/<server name> <server name>
Setspn /S WSMAN/<FQDN of server> <server name>
Por fim, no gateway de Windows Admin Center, execute o seguinte para garantir que obtém novas informações do servidor do controlador de domínio:
Klist purge
Notificação de atualização incorreta no Windows Admin Center
Se receber uma mensagem de notificação de atualização incorreta "Versão nula do módulo AksHci PowerShell instalada com êxito", a operação de atualização será bem-sucedida mesmo que a notificação seja enganosa.
Pode ignorar esta mensagem com segurança.
Acesso negado
Na Fase 2.1: Componente do Passo Básico, poderá encontrar este erro: "A ligação ao servidor remoto *** falhou com a seguinte mensagem de erro: Acesso negado. Para obter mais informações, consulte o tópico about_Remote_Troubleshooting Ajuda" ao tentar utilizar as suas credenciais para os nós do servidor.
Certifique-se de que a conta/credenciais adicionadas é uma conta administrativa no computador. Em seguida, verifique se o PSRemoting está ativado e se os anfitriões remotos são fidedignos. Pode fazê-lo com os seguintes comandos do PowerShell:
Enable-PSRemoting -Force
winrm quickconfig
Se ainda estiver a ter problemas, veja este guia de resolução de problemas.
Windows Admin Center não tem uma experiência de offboard do Arc
Windows Admin Center não tem atualmente um processo para off-board de um cluster do Azure Arc.
Para eliminar agentes do Arc num cluster que foi destruído, navegue para o grupo de recursos do cluster no portal do Azure e elimine manualmente o conteúdo do Arc. Para eliminar agentes do Arc num cluster que ainda está em execução, deve executar o seguinte comando:
az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest
Nota
Se utilizar o portal do Azure para eliminar o recurso do Kubernetes compatível com o Arc, este remove todos os recursos de configuração associados, mas não remove os agentes em execução no cluster. A melhor prática é eliminar o recurso do Kubernetes com az connectedk8s delete o em vez do portal do Azure.
Windows Admin Center dashboard de atualização não é atualizado após atualizações com êxito
Após uma atualização com êxito, o dashboard Windows Admin Center atualização ainda mostra a versão anterior.
Atualize o browser para corrigir este problema.
Resolver problemas do CredSSP
Quando implementa o AKS Arc com Windows Admin Center e a implementação bloqueia durante um período prolongado, poderá estar a ter problemas de conectividade ou de Fornecedor de Suporte de Segurança de Credenciais (CredSSP).
Experimente os seguintes passos para resolver problemas de implementação:
No computador com Windows Admin Center, execute o seguinte comando numa janela do PowerShell:
Enter-PSSession <servername>Se este comando for bem-sucedido, pode ligar ao servidor e não existe nenhum problema de conectividade.
Se estiver a ter problemas com CredSSP, execute este comando para testar a confiança entre o computador do gateway e o computador de destino:
Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSPTambém pode executar o seguinte comando para testar a confiança no acesso ao gateway local:
Enter-PSSession -computer localhost -credential (Get-Credential)
Para obter sugestões adicionais de resolução de problemas do CredSSP, veja Resolver problemas do CredSSP.
É apresentado um erro de tempo limite ao tentar ligar um cluster de cargas de trabalho do AKS ao Azure Arc através de Windows Admin Center
Por vezes, devido a problemas de rede, Windows Admin Center excede o tempo limite durante uma ligação ao Arc.
Utilize o comando do PowerShell Enable-AksHciArcConnection para ligar o cluster de cargas de trabalho do AKS ao Azure Arc enquanto trabalhamos ativamente para melhorar a experiência do utilizador.
"Install-Module" não foi reconhecido
Na fase 2.1: Validação do Sistema, poderá obter um erro: "O item "Install-Module" não foi reconhecido como o nome de um cmdlet, função, ficheiro de script ou programa executável".
Verifique a ortografia do nome. Se o caminho estiver incluído, certifique-se de que o caminho está correto. Em seguida, tente novamente quando instalar. Conclua os comandos do PowerShell nos nós nos quais está a tentar implementar. Execute o seguinte comando para resolver o problema (certifique-se de que a versão do PowerShell é, pelo menos, 5.1):
Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck
Em seguida, execute estes comandos se encontrar erros do primeiro comando:
Get-PSRepository
Register-PSRepository -Default
Não é possível ligar Windows Admin Center ao Azure ao criar um novo ID de Aplicação Azure AD
Não é possível ligar Windows Admin Center ao Azure porque não pode criar e utilizar automaticamente um ID de Aplicação Azure AD no gateway.
Crie um ID de Aplicação Azure AD e atribua-lhe as permissões certas no portal. Em seguida, selecione Utilizar existente no gateway. Para obter mais informações, visite Ligar o gateway ao Azure.
Ao atualizar a versão do Kubernetes, a página de atualização mostra que a atualização ainda está a ser processada quando a atualização é concluída
Se tiver clusters de cargas de trabalho com a versão 1.19.9 do Kubernetes instalada e, em seguida, utilizar Windows Admin Center para os atualizar para a versão 1.19.11 do Kubernetes, a página de atualização do Kubernetes continua a mostrar que a atualização ainda está em curso. No entanto, se executar Get-AksHciCluster, a saída mostra que a atualização está concluída e, se abrir Windows Admin Center num novo separador, o cluster é atualizado para 1.19.11 na lista de clusters do Kubernetes.
Pode ignorar este problema à medida que o processo de atualização foi concluído.
Criar registos de Windows Admin Center
Quando comunica problemas com Windows Admin Center, recomendamos que anexe registos para ajudar a equipa de desenvolvimento a diagnosticar o seu problema. Os erros no Windows Admin Center geralmente vêm de uma de duas formas:
- Eventos que aparecem no visualizador de eventos no computador com Windows Admin Center
- Problemas de JavaScript que aparecem na consola do browser
Para recolher registos para Windows Admin Center, utilize o Get-SMEUILogs.ps1 script fornecido no pacote de pré-visualização pública.
Para utilizar o script, execute este comando na pasta onde o script está armazenado:
./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt
O comando tem os seguintes parâmetros:
-ComputerNames: uma lista das máquinas das quais pretende recolher registos.-Destination: o computador ao qual pretende agregar os registos.-HoursAgo: a hora de início para recolher registos, expressa em horas antes da hora em que executa o script.-NoCredentialPrompt: um comutador para desativar o pedido de credenciais e utilizar as credenciais predefinidas no seu ambiente atual.
Se tiver dificuldades em executar este script, pode executar o seguinte comando para ver o texto da Ajuda:
GetHelp .\Get-SMEUILogs.ps1 -Examples
Executar uma atualização resulta no erro: "Ocorreu um erro ao obter informações de atualização da plataforma"
Ao executar uma atualização no Windows Admin Center, ocorreu o seguinte erro:
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.
Normalmente, esta mensagem de erro ocorre quando o AKS no Azure Stack HCI é implementado num ambiente com um proxy configurado. Atualmente, Windows Admin Center não tem suporte para instalar módulos num ambiente proxy.
Para resolver este erro, configure o AKS no Azure Stack HCI com o comando proxy do PowerShell.
Implementação: Falha ao ligar ao localhost do servidor remoto
A implementação do cluster anfitrião do AKS falha nas verificações do sistema com um erro do serviço WinRM.
Experimente aplicar as soluções sugeridas na Resolução de problemas manual.
Quando são instaladas várias versões dos módulos do PowerShell, Windows Admin Center não escolhe a versão mais recente
Se tiver várias versões dos módulos do PowerShell instaladas (por exemplo, 0.2.26, 0.2.27 e 0.2.28), Windows Admin Center poderá não utilizar a versão mais recente (ou a versão necessária).
Certifique-se de que tem apenas um módulo do PowerShell instalado. Deve desinstalar todas as versões não utilizadas do PowerShell dos módulos do PowerShell e deixar apenas uma instalada. Mais informações sobre qual Windows Admin Center versão é compatível com a qual a versão do PowerShell pode ser encontrada nas notas de versão do AKS no Azure Stack HCI..
Durante a implementação, é apresentado o erro "Não foi encontrada nenhuma correspondência para os critérios de pesquisa especificados para o fornecedor **NuGet**"
Este erro é apresentado ao implementar através de Windows Admin Center. O fornecedor de pacotes requer as PackageManagement etiquetas e Provider . Deve verificar se o pacote especificado tem um erro de etiqueta ao tentar uma implementação através de Windows Admin Center.
Este erro provém do PowerShell e afirma que existem problemas de conectividade à Internet. O PowerShell está a tentar instalar o pacote de pré-requisitos e não consegue instalá-lo.
Verifique se o servidor ou cluster de ativação pós-falha tem conectividade à Internet e, em seguida, inicie uma nova instalação.
Na Fase 2.1: Validação do Sistema, pode haver um erro ao aceder à instalação: 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. conclua os comandos do PowerShell nos nós nos quais está a tentar implementar. Terá de instalar manualmente o NuGet com o seguinte comando do PowerShell:
Install-PackageProvider -Name NuGet -Scope CurrentUser -Force
Depois de executar esse comando, feche todas as janelas do PowerShell abertas e tente novamente no Windows Admin Center.
Não é possível encontrar o repositório "PSGallery"
Na fase 2.1: Validação do Sistema, poderá encontrar este erro: "Não é possível localizar o repositório "PSGallery".
Utilize Get-PSRepository para ver todos os repositórios disponíveis. Quando clicar em instalar. Conclua os comandos do PowerShell nos nós nos quais está a tentar implementar. Anule o registo e volte a registar o PSRepository numa janela administrativa do PowerShell. Feche todas as janelas do PowerShell posteriormente.
Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default
Em seguida, desinstale e reinstale o PowerShellGet numa janela administrativa do PowerShell. Feche todas as janelas do PowerShell posteriormente.
Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force
Depois disso, volte a Windows Admin Center e repita.
Ocorre um erro ao tentar utilizar Windows Admin Center
Se instalar Windows Admin Center com uma conta e tentar utilizá-la com outra, obterá erros.
Para o CredSSP funcionar com êxito no assistente de Criação de Clusters, Windows Admin Center têm de ser instaladas e utilizadas pela mesma conta.
O erro "Não é possível indexar numa matriz nula" é apresentado ao criar um cluster de carga de trabalho compatível com o Arc
Este erro é apresentado ao mover do PowerShell para o Windows Admin Center para criar um cluster de cargas de trabalho compatíveis com o Arc.
Pode ignorar este erro com segurança. Faz parte do passo de validação e o cluster já foi criado.
Reiniciar nós do Azure Stack HCI causa um problema de temporização
Reiniciar os nós de cluster do Azure Stack HCI que alojam clusters de gestão e clusters de cargas de trabalho pode fazer com que os clusters de carga de trabalho desapareçam do dashboard de Windows Admin Center.
Para contornar este problema, coloque em pausa e esvazie os nós antes de planear reiniciá-los. Por vezes, os clusters de carga de trabalho podem demorar mais tempo a aparecer no dashboard.
Não é possível implementar o AKS num ambiente que tenha clusters de armazenamento e computação separados
Windows Admin Center não implementará Azure Kubernetes Service num ambiente com clusters de armazenamento e computação separados, uma vez que espera que os recursos de computação e armazenamento sejam fornecidos pelo mesmo cluster. Na maioria dos casos, não encontrará CSVs expostos pelo cluster de computação e recusar-se-á a continuar com a implementação.
Passos seguintes
- Descrição geral da resolução de problemas
- Problemas e erros de instalação
- Problemas conhecidos da atualização
Se continuar a deparar-se com problemas quando estiver a utilizar o AKS Arc, pode registar erros através do GitHub.