Este artigo descreve problemas conhecidos com Windows Admin Center para AKS Arc. Você também pode examinar problemas e erros de atualização e instalação.
Ocorreram problemas ao registrar o gateway de Windows Admin Center com o Azure
Se você acabou de criar uma nova conta do Azure e ainda não entrou na conta em seu computador de gateway, poderá ter problemas ao registrar seu gateway de Windows Admin Center no Azure.
Para atenuar esse problema, entre em sua conta do Azure em outra guia ou janela do navegador e registre o gateway de Windows Admin Center com o Azure.
Somente o usuário que configurou o host do AKS pode criar clusters
Ao implantar Serviço de Kubernetes do Azure no Azure Stack HCI por meio de Windows Admin Center, somente o usuário que configurou o host do AKS pode criar clusters do Kubernetes.
Para contornar esse problema, copie a pasta wssd do perfil do usuário que configurou o host do AKS para o perfil do usuário que criará os novos clusters do Kubernetes.
Recuperando-se de uma implantação do AKS com falha no Azure Stack HCI
Você está enfrentando problemas de implantação ou deseja redefinir sua implantação.
Feche todas as instâncias de Windows Admin Center conectadas a Serviço de Kubernetes do Azure no Azure Stack HCI antes de executar Uninstall-AksHci de uma janela administrativa do PowerShell.
O assistente de Instalação ou Criação de Cluster exibe um erro sobre uma configuração errada
Você pode receber um erro em qualquer um dos assistentes sobre uma configuração errada.
Executar operações de limpeza de cluster. Essas operações podem envolver a remoção do arquivo C:\Program Files\AksHci\mocctl.exe .
Os nomes de campo de rede são inconsistentes em Windows Admin Center
Há inconsistências em nomes de campo de rede que aparecem no fluxo de implantação do cluster de host e no fluxo de implantação do cluster de carga de trabalho.
N/D
No Windows Admin Center, a mensagem "erro ao criar a entidade de serviço" é exibida durante a instalação de um host do AKS no Azure Stack HCI
Você receberá esse erro se tiver desabilitado pop-ups. O Google Chrome bloqueia pop-ups por padrão e, portanto, o pop-up de entrada do Azure é bloqueado e causa o erro da entidade de serviço.
Habilitar pop-ups.
Um erro do WinRM é exibido ao criar um cluster de carga de trabalho
Ao alternar de DHCP para IP estático, Windows Admin Center exibiu um erro que dizia que o cliente WinRM não pode processar a solicitação. Esse erro também ocorreu fora do Windows Admin Center. O WinRM foi quebrado quando endereços IP estáticos foram usados e os servidores não estavam registrando um SPN (Nome da Entidade de Serviço) ao migrar para endereços IP estáticos.
Para resolve esse problema, use o comando SetSPN para criar o SPN. Em um prompt de comando no gateway de Windows Admin Center, execute o seguinte comando:
Setspn /Q WSMAN/<FQDN on the Azure Stack HCI Server>
Em seguida, se qualquer um dos servidores no ambiente retornar a mensagem No Such SPN Found, faça logon 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 ele obtenha novas informações de servidor do controlador de domínio:
Klist purge
Notificação de atualização incorreta no Windows Admin Center
Se você receber uma mensagem de notificação de atualização incorreta "Versão nula do módulo do AksHci PowerShell instalada com êxito", a operação de atualização será bem-sucedida mesmo que a notificação seja enganosa.
Você pode ignorar essa mensagem com segurança.
Acesso negado
Na Fase 2.1: Componente de Etapa Básica, você pode encontrar este erro: "Falha ao conectar-se ao servidor remoto *** com a seguinte mensagem de erro: o acesso foi negado. Para obter mais informações, consulte o tópico about_Remote_Troubleshooting Ajuda" ao tentar usar suas credenciais para seus nós de servidor.
Verifique se a conta/credenciais adicionadas é uma conta administrativa no computador. Em seguida, verifique se o PSRemoting está habilitado e se os hosts remotos são confiáveis. Você pode fazer isso com os seguintes comandos do PowerShell:
Enable-PSRemoting -Force
winrm quickconfig
Se você ainda estiver encontrando problemas, consulte este guia de solução de problemas.
Windows Admin Center não tem uma experiência de remoção do Arc
Windows Admin Center atualmente não tem um processo para desligar um cluster do Azure Arc.
Para excluir agentes do Arc em um cluster que foi destruído, navegue até o grupo de recursos do cluster no portal do Azure e exclua manualmente o conteúdo do Arc. Para excluir agentes do Arc em um cluster que ainda está em execução, execute o seguinte comando:
az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest
Observação
Se você usar o portal do Azure para excluir o recurso kubernetes habilitado para Arc, ele removerá todos os recursos de configuração associados, mas não removerá os agentes em execução no cluster. A melhor prática é excluir o recurso kubernetes usando az connectedk8s delete em vez do portal do Azure.
Windows Admin Center atualização dashboard não é atualizada após atualizações bem-sucedidas
Após uma atualização bem-sucedida, a atualização Windows Admin Center dashboard ainda mostra a versão anterior.
Atualize o navegador para corrigir esse problema.
Solucionar problemas de CredSSP
Quando você implanta o AKS Arc usando Windows Admin Center e a implantação trava por um longo período, você pode estar tendo o CredSSP (Provedor de Suporte de Segurança de Credencial) ou problemas de conectividade.
Experimente as seguintes etapas para solucionar problemas de implantação:
No computador que executa Windows Admin Center, execute o seguinte comando em uma janela do PowerShell:
Enter-PSSession <servername>Se esse comando for bem-sucedido, você poderá se conectar ao servidor e não haverá nenhum problema de conectividade.
Se você estiver tendo problemas de CredSSP, execute este comando para testar a confiança entre o computador de gateway e o computador de destino:
Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSPVocê també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 dicas adicionais de solução de problemas do CredSSP, consulte Solucionar problemas de CredSSP.
Um erro de tempo limite aparece ao tentar conectar um cluster de carga de trabalho do AKS ao Azure Arc por meio de Windows Admin Center
Às vezes, devido a problemas de rede, Windows Admin Center atinge o tempo limite durante uma conexão do Arc.
Use o comando do PowerShell Enable-AksHciArcConnection para conectar o cluster de carga de trabalho do AKS ao Azure Arc enquanto trabalhamos ativamente para melhorar a experiência do usuário.
'Install-Module' não foi reconhecido
Na fase 2.1: Validação do sistema, você pode receber um erro: "O item 'Install-Module' não foi reconhecido como o nome de um cmdlet, função, arquivo de script ou programa executável".
Verifique a ortografia do nome. Se o caminho estiver incluído, verifique se o caminho está correto. Em seguida, tente novamente ao instalar. Conclua os comandos do PowerShell nos nós nos quais você está tentando implantar. Execute o seguinte comando para resolve o problema (verifique se 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 conectar Windows Admin Center ao Azure ao criar uma nova ID de Azure App
Não é possível conectar Windows Admin Center ao Azure porque você não pode criar e usar automaticamente uma ID de Azure App no gateway.
Crie uma ID de Azure App e atribua as permissões corretas no portal. Em seguida, selecione Usar existente no gateway. Para obter mais informações, visite conectando seu gateway ao Azure.
Ao atualizar a versão do Kubernetes, a página de atualização mostra que a atualização ainda está sendo processada quando a atualização é concluída
Se você tiver clusters de carga de trabalho com o Kubernetes versão 1.19.9 instalado e usar Windows Admin Center para atualizá-los para o Kubernetes versão 1.19.11, a página de atualização do Kubernetes continuará mostrando que a atualização ainda está em processo. No entanto, se você executar Get-AksHciCluster, a saída mostrará que a atualização foi concluída e, se você abrir Windows Admin Center em uma nova guia, o cluster será atualizado para 1.19.11 na lista de clusters do Kubernetes.
Você pode ignorar esse problema conforme o processo de atualização foi concluído.
Criar logs de Windows Admin Center
Quando você relata problemas com Windows Admin Center, é uma boa ideia anexar logs para ajudar a equipe de desenvolvimento a diagnosticar seu problema. Os erros em Windows Admin Center geralmente vêm em uma das duas formas:
- Eventos que aparecem no visualizador de eventos no computador executando Windows Admin Center
- Problemas do JavaScript que surgem no console do navegador
Para coletar logs para Windows Admin Center, use o Get-SMEUILogs.ps1 script fornecido no pacote de visualização pública.
Para usar o script, execute este comando na pasta em que 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 de computadores dos quais você deseja coletar logs. -
-Destination: o computador ao qual você deseja agregar os logs. -
-HoursAgo: a hora de início da coleta de logs, expressa em horas antes da hora em que você executa o script. -
-NoCredentialPrompt: um comutador para desativar o prompt de credenciais e usar as credenciais padrão em seu ambiente atual.
Se você tiver dificuldades para executar esse script, poderá executar o seguinte comando para exibir o texto da Ajuda:
GetHelp .\Get-SMEUILogs.ps1 -Examples
A execução de uma atualização resulta no erro: "Erro ao buscar 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.
Essa mensagem de erro normalmente ocorre quando o AKS no Azure Stack HCI é implantado em um ambiente que tem um proxy configurado. Atualmente, Windows Admin Center não tem suporte para instalar módulos em um ambiente de proxy.
Para resolve esse erro, configure o AKS no Azure Stack HCI usando o comando proxy do PowerShell.
Implantação: falha ao conectar-se ao localhost do servidor remoto
A implantação do cluster de host do AKS falha em verificações do sistema com um erro de serviço WinRM.
Tente aplicar as soluções sugeridas na solução de problemas manual.
Quando várias versões dos módulos do PowerShell são instaladas, Windows Admin Center não escolhe a versão mais recente
Se você 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 usar a versão mais recente (ou a necessária).
Verifique se você tem apenas um módulo do PowerShell instalado. Você deve desinstalar todas as versões do PowerShell não utilizados dos módulos do PowerShell e deixar apenas uma instalada. Mais informações sobre qual versão Windows Admin Center é compatível com qual versão do PowerShell pode ser encontrada nas notas de versão do AKS no Azure Stack HCI.
Durante a implantação, o erro "Nenhuma correspondência foi encontrada para os critérios de pesquisa especificados para o provedor **NuGet**" é exibido
Esse erro aparece ao implantar por meio de Windows Admin Center. O provedor de pacotes requer as PackageManagement marcas e Provider . Você deve marcar se o pacote especificado tiver um erro de marca ao tentar uma implantação por meio de Windows Admin Center.
Esse erro vem do PowerShell e afirma que há problemas de conectividade com a Internet. O PowerShell está tentando instalar o pacote de pré-requisitos e não consegue instalá-lo.
Verifique se o servidor ou cluster de failover tem conectividade com a Internet e inicie uma nova instalação.
No Estágio 2.1: Validação do Sistema, pode haver um erro quando você atinge a 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 você está tentando implantar. Você precisará instalar manualmente o NuGet usando 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 localizar o repositório 'PSGallery'
Na fase 2.1: Validação do sistema, você pode encontrar este erro: 'Não é possível localizar o repositório 'PSGallery'.
Use Get-PSRepository para ver todos os repositórios disponíveis.' ao clicar em instalar. Conclua os comandos do PowerShell nos nós nos quais você está tentando implantar. Cancele o registro e registre novamente o PSRepository em uma 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 em uma janela administrativa do PowerShell. Feche todas as janelas do PowerShell posteriormente.
Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force
Depois disso, volte para Windows Admin Center e tente novamente.
Ocorre um erro ao tentar usar Windows Admin Center
Se você instalar Windows Admin Center com uma conta e tentar usá-la com outra, receberá erros.
Para que o CredSSP funcione com êxito no assistente de Criação de Cluster, Windows Admin Center deve ser instalado e usado pela mesma conta.
O erro "Não é possível indexar em uma matriz nula" é exibido ao criar um cluster de carga de trabalho habilitado para Arc
Esse erro aparece ao mover do PowerShell para o Windows Admin Center para criar um cluster de carga de trabalho habilitado para Arc.
Você pode ignorar com segurança esse erro. Ele faz parte da etapa de validação e o cluster já foi criado.
Reiniciar nós do Azure Stack HCI causa um problema de tempo
Reiniciar os nós de cluster do Azure Stack HCI que hospedam o cluster de gerenciamento e os clusters de carga de trabalho pode fazer com que os clusters de carga de trabalho desapareçam do Windows Admin Center dashboard.
Para contornar esse problema, pause e escorra os nós antes de planejar reiniciá-los. Às vezes, os clusters de carga de trabalho podem demorar mais para aparecer no dashboard.
Não é possível implantar o AKS em um ambiente que tenha clusters de computação e armazenamento separados
Windows Admin Center não implantará Serviço de Kubernetes do Azure em um ambiente com clusters de computação e armazenamento separados, pois espera que os recursos de computação e armazenamento sejam fornecidos pelo mesmo cluster. Na maioria dos casos, ele não encontrará CSVs expostos pelo cluster de computação e se recusará a continuar com a implantação.
Próximas etapas
Se você continuar tendo problemas ao usar o AKS Arc, poderá arquivar bugs por meio do GitHub.