Serviço de resolução de problemas Azure Kubernetes em Azure Stack HCITroubleshooting Azure Kubernetes Service on Azure Stack HCI

Quando cria ou gere um cluster Kubernetes utilizando o Serviço Azure Kubernetes no Azure Stack HCI, poderá ocasionalmente encontrar problemas.When you create or manage a Kubernetes cluster by using Azure Kubernetes Service on Azure Stack HCI, you might occasionally come across problems. Este artigo fornece diretrizes de resolução de problemas para ajudá-lo a resolver esses problemas.This article provides troubleshooting guidelines to help you resolve those problems.

Resolução de problemas Azure Stack HCITroubleshooting Azure Stack HCI

Para verificar a validação do cluster de resolução de problemas para as definições de QoS (qualidade de serviço) de rede e armazenamento em servidores num cluster HCI da Pilha de Azure e verificar se são definidas regras importantes, consulte relatórios de validação de clusters de resolução de problemas.To troubleshoot cluster validation reporting for network and storage QoS (quality of service) settings across servers in an Azure Stack HCI cluster and verify that important rules are defined, see Troubleshoot cluster validation reporting.

Para conhecer os problemas de resolução de problemas com o CredSSP, consulte o Troubleshoot CredSSP.To learn about troubleshooting problems with CredSSP, see Troubleshoot CredSSP.

Resolução de problemas do Centro de Administração do WindowsTroubleshooting Windows Admin Center

Este produto está em pré-visualização pública, o que significa que ainda está em desenvolvimento.This product is in public preview, which means it's still in development. Existem atualmente alguns problemas com a extensão do Serviço Admin Center Azure Kubernetes:There are currently some issues with the Windows Admin Center Azure Kubernetes Service extension:

  • Atualmente, cada servidor no cluster do sistema que está a utilizar para configurar o Serviço Azure Kubernetes no Azure Stack HCI deve ser um servidor de confiança.Currently, each server in the cluster of the system you're using to set up Azure Kubernetes Service on Azure Stack HCI must be a trusted server. Assim, o Windows Admin Center deve ser capaz de executar operações credSSP em todos os servidores do cluster, e não apenas em um ou alguns deles.So Windows Admin Center must be able to run CredSSP operations on every server in the cluster, not just on one or a few of them.

  • Se tiver um erro que diga msft.sme.aks couldn't load que o erro diz que os pedaços de carregamento falharam, utilize a versão mais recente do Microsoft Edge ou do Google Chrome e tente novamente.If you get an error that says msft.sme.aks couldn't load, and the error says that loading chunks failed, use the latest version of Microsoft Edge or Google Chrome and try again.

  • Antes de iniciar o assistente para configurar o anfitrião do Serviço Azure Kubernetes ou o assistente para criar um cluster Kubernetes, deverá iniciar sessão no Azure através do Windows Admin Center.Before you start either the wizard for setting up Azure Kubernetes Service host or the wizard for creating a Kubernetes cluster, you should sign in to Azure through Windows Admin Center. Pode ter de voltar a inscrever-se durante o fluxo de trabalho.You might need to sign in again during the workflow. Se tiver dificuldades em iniciar sessão no Azure através do Windows Admin Center, tente iniciar sessão na sua conta Azure a partir de outra fonte, como o portal Azure.If you're having difficulties signing in to Azure through Windows Admin Center, try signing in to your Azure account from another source, like the Azure portal. Se continuar a ter problemas, consulte o windows Admin Center, artigo de emissão conhecido antes de contactar o suporte.If you continue to have problems, check the Windows Admin Center known issues article before you contact support.

  • Na iteração atual do Serviço Azure Kubernetes na implementação do Azure Stack HCI através do Windows Admin Center, apenas o utilizador que criou o anfitrião do Serviço Azure Kubernetes pode criar clusters Kubernetes no sistema.In the current iteration of Azure Kubernetes Service on Azure Stack HCI deployment through Windows Admin Center, only the user who set up the Azure Kubernetes Service host can create Kubernetes clusters on the system. Para contornar este problema, copie a pasta .wssd do perfil do utilizador que criou o anfitrião do Serviço Azure Kubernetes para o perfil do utilizador que irá criar o novo cluster Kubernetes.To work around this issue, copy the .wssd folder from the profile of the user who set up the Azure Kubernetes Service host to the profile of the user who will be creating the new Kubernetes cluster.

  • Se receber um erro em qualquer um dos assistentes sobre uma configuração errada, execute operações de limpeza de clusters.If you receive an error in either wizard about a wrong configuration, perform cluster cleanup operations. Estas operações podem envolver a remoção do ficheiro C:\Programa Files\AksHci\mocctl.exe.These operations might involve removing the C:\Program Files\AksHci\mocctl.exe file.

  • Para que o CredSSP funcione com sucesso no assistente de criação de clusters, o Windows Admin Center deve ser instalado e utilizado pela mesma conta.For CredSSP to function successfully in the cluster creation wizard, Windows Admin Center must be installed and used by the same account. Se instalar o Windows Admin Center com uma conta e tentar usá-lo com outra, terá erros.If you install Windows Admin Center with one account and try to use it with another, you'll get errors.

  • Durante a implantação do cluster, poderá encontrar um problema com a transferência de ficheiros helm.zip.During cluster deployment, you might encounter a problem with the helm.zip file transfer. Este problema muitas vezes causa um erro que diz que o caminho para o helm.zip ficheiro não existe ou não é válido.This problem often causes an error that says the path to the helm.zip file doesn't exist or isn't valid. Para resolver este problema, recandidutar a implantação.To resolve this problem, retry the deployment.

  • Se a sua implementação se prolongar por um período prolongado, poderá estar a ter problemas de CredSSP ou de conectividade.If your deployment hangs for an extended period, you might be having CredSSP or connectivity problems. Experimente estes passos para resolver problemas na sua implantação:Try these steps to troubleshoot your deployment:

    1. Na máquina que executa o Windows Admin Center, executa o seguinte comando numa janela PowerShell:On the machine running Windows Admin Center, run the following command in a PowerShell window:

      Enter-PSSession <servername>
      
    2. Se este comando for bem sucedido, pode ligar-se ao servidor e não há problema de conectividade.If this command succeeds, you can connect to the server and there's no connectivity issue.

    3. Se tiver problemas com o CredSSP, faça este comando para testar a confiança entre a máquina de gateway e a máquina alvo:If you're having CredSSP problems, run this command to test the trust between the gateway machine and the target machine:

      Enter-PSSession –ComputerName <server> –Credential company\administrator –Authentication CredSSP
      

      Também pode executar o seguinte comando para testar a confiança no acesso ao gateway local:You can also run the following command to test the trust in accessing the local gateway:

      Enter-PSSession -computer localhost -credential (Get-Credential)
      
  • Se estiver a usar o Azure Arc e tiver várias identificações de inquilinos, faça o seguinte comando para especificar o seu inquilino desejado antes da sua implantação.If you're using Azure Arc and have multiple tenant IDs, run the following command to specify your desired tenant before deployment. Se não o fizeres, o teu destacamento pode falhar.If you don't, your deployment might fail.

    az login –tenant <tenant>
    
  • Se acabou de criar uma nova conta Azure e ainda não assinou a conta na sua máquina de gateway, poderá ter problemas em registar o seu portal do Windows Admin Center com o Azure.If you've just created a new Azure account and haven't signed in to the account on your gateway machine, you might experience problems with registering your Windows Admin Center gateway with Azure. Para mitigar este problema, inscreva-se na sua conta Azure em outro separador ou janela do navegador e, em seguida, registe a porta de entrada do Windows Admin Center para Azure.To mitigate this problem, sign in to your Azure account in another browser tab or window, and then register the Windows Admin Center gateway to Azure.

Criação de registos do Windows Admin CenterCreating Windows Admin Center logs

Quando relata problemas com o Windows Admin Center, é uma boa ideia anexar registos para ajudar a equipa de desenvolvimento a diagnosticar o seu problema.When you report problems with Windows Admin Center, it's a good idea to attach logs to help the development team diagnose your problem. Os erros no Windows Admin Center geralmente vêm de uma de duas formas:Errors in Windows Admin Center generally come in one of two forms:

  • Eventos que aparecem no espectador do evento na máquina que executa o Windows Admin CenterEvents that appear in the event viewer on the machine running Windows Admin Center
  • Problemas javaScript que surgem na consola do navegadorJavaScript problems that surface in the browser console

Para recolher registos para o Windows Admin Center, utilize o script Get-SMEUILogs.ps1 fornecido no pacote de pré-visualização público.To collect logs for Windows Admin Center, use the Get-SMEUILogs.ps1 script that's provided in the public preview package.

Para utilizar o script, execute este comando na pasta onde o seu script está armazenado:To use the script, run this command in the folder where your script is stored:

./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt

O comando tem os seguintes parâmetros:The command has the following parameters:

  • -ComputerNames: Uma lista de máquinas a partir das quais pretende recolher registos.-ComputerNames: A list of machines you want to collect logs from.
  • -Destination: A máquina a que pretende agregar os troncos.-Destination: The machine you want to aggregate the logs to.
  • -HoursAgo: A hora de início da recolha de registos, expressa horas antes da hora de execução do script.-HoursAgo: The start time for collecting logs, expressed in hours before the time you run the script.
  • -NoCredentialPrompt: Um interruptor para desligar as credenciais e utilizar as credenciais padrão no seu ambiente atual.-NoCredentialPrompt: A switch to turn off the credentials prompt and use the default credentials in your current environment.

Se tiver dificuldades em executar este script, pode executar o seguinte comando para visualizar o texto de ajuda:If you have difficulties running this script, you can run the following command to view the Help text:

GetHelp .\Get-SMEUILogs.ps1 -Examples

Os acenos dos trabalhadores do Windows que solucionam problemasTroubleshooting Windows worker nodes

Para iniciar sedução num nó de trabalhador do Windows, obtenha primeiro o endereço IP do seu nó executando kubectl get .To sign in to a Windows worker node, first get the IP address of your node by running kubectl get. Reparem no EXTERNAL-IP valor.Note the EXTERNAL-IP value.

kubectl get nodes -o wide

SSH no nó ssh Administrator@ip utilizando.SSH into the node by using ssh Administrator@ip. Depois de ter SSH no nó, pode correr net user administrator * para atualizar a sua senha de administrador.After you SSH into the node, you can run net user administrator * to update your administrator password.

Os nódos de trabalhadores linux de resolução de problemasTroubleshooting Linux worker nodes

Para iniciar sedução num nó de trabalhador linux, obtenha primeiro o endereço IP do seu nó funcionando kubectl get .To sign in to a Linux worker node, first get the IP address of your node by running kubectl get. Reparem no EXTERNAL-IP valor.Note the EXTERNAL-IP value.

kubectl get nodes -o wide

SSH no nó ssh clouduser@ip utilizando.SSH into the node by using ssh clouduser@ip.

Resolução de problemas Azure Arc KubernetesTroubleshooting Azure Arc Kubernetes

Para conhecer a resolução de cenários comuns relacionados com a conectividade, permissões e agentes da Arc, consulte Azure Arc habilitado a resolução de problemas de Kubernetes.To learn about troubleshooting common scenarios related to connectivity, permissions, and Arc agents, see Azure Arc enabled Kubernetes troubleshooting.

Passos seguintesNext steps

Se continuar a ter problemas quando estiver a utilizar o Serviço Azure Kubernetes no Azure Stack HCI, pode arquivar bugs através do GitHub.If you continue to run into problems when you're using Azure Kubernetes Service on Azure Stack HCI, you can file bugs through GitHub.