Diagnosticar problemas de conexão para clusters do Kubernetes habilitados para Azure Arc

Se você estiver enfrentando problemas ao conectar um cluster ao Azure Arc, é provavelmente devido a um dos problemas listados aqui. Fornecemos dois fluxogramas com ajuda guiada: um se você não estiver usando um servidor proxy e outro que se aplica se a conexão de rede usar um servidor proxy.

Dica

As etapas neste fluxograma se aplicam se você estiver usando a CLI do Azure ou o Azure PowerShell para conectar seu cluster. No entanto, algumas das etapas exigem o uso da CLI do Azure. Se você ainda não instalou a CLI do Azure, faça isso antes de começar.

Conexões sem um proxy

Examine este fluxograma para diagnosticar seu problema ao tentar conectar um cluster ao Azure Arc sem um servidor proxy. Mais detalhes sobre cada item são fornecidos abaixo.

A identidade do Azure tem permissões suficientes?

Examine os prerrequisitos para conectar um cluster e verifique se a identidade que você está usando para conectar o cluster tem as permissões necessárias.

Você está executando a versão mais recente da CLI do Azure?

Verifique se você tem a versão mais recente instalada.

Se você conectou seu cluster usando o Azure PowerShell, certifique-se de estar executando a versão mais recente.

A extensão connectedk8s é a versão mais recente?

Atualize a extensão connectedk8s da CLI do Azure para a versão mais recente executando este comando:

az extension update --name connectedk8s

Se você ainda não instalou a extensão, poderá fazer isso executando o seguinte comando:

az extension add --name connectedk8s

O kubeconfig está apontando para o cluster certo?

Execute kubectl config get-contexts para confirmar o nome do contexto de destino. Em seguida, defina o contexto padrão para o cluster certo executando kubectl config use-context <target-cluster-name>.

Todos os provedores de recursos necessários estão registrados?

Verifique se os provedores de recursos Microsoft.Kubernetes, Microsoft.KubernetesConfiguration e Microsoft.ExtendedLocation estão registrados.

Todos os requisitos de rede foram atendidos?

Examine os requisitos de rede e verifique se nenhum ponto de extremidade necessário está bloqueado.

Todos os pods no namespace azure-arc estão em execução?

Se tudo estiver funcionando corretamente, todos os pods deverão estar no estado Running. Execute kubectl get pods -n azure-arc para confirmar se o estado de algum pod não é Running.

Ainda está tendo problemas?

As etapas acima resolverão muitos problemas comuns de conexão, mas se você ainda não conseguir se conectar com êxito, gere um arquivo de log de solução de problemas e abra uma solicitação de suporte para que possamos investigar o problema mais a fundo.

Para gerar o arquivo de log de solução de problemas, execute o seguinte comando:

az connectedk8s troubleshoot -g <myResourceGroup> -n <myK8sCluster>

Ao criar sua solicitação de suporte, na seção Detalhes adicionais, use a opção Upload de arquivo para carregar o arquivo de log gerado.

Conexões com um servidor proxy

Se você estiver usando um servidor proxy em pelo menos um computador, conclua as cinco primeiras etapas do fluxograma não proxy (por meio do registro do provedor de recursos) para as etapas básicas de solução de problemas. Em seguida, se você ainda estiver encontrando problemas, examine o próximo fluxograma para obter etapas adicionais de solução de problemas. Mais detalhes sobre cada item são fornecidos abaixo.

O computador está executando comandos por trás de um servidor proxy?

Se o computador estiver executando comandos protegidos por um servidor proxy, você precisará definir todas as variáveis de ambiente necessárias. Para obter mais informações, confira Conectar-se usando um servidor proxy de saída.

Por exemplo:

export HTTP_PROXY="http://<proxyIP>:<proxyPort>"
export HTTPS_PROXY="https://<proxyIP>:<proxyPort>"
export NO_PROXY="<cluster-apiserver-ip-address>:<proxyPort>"

O servidor proxy aceita apenas certificados confiáveis?

Certifique-se de incluir o caminho do arquivo de certificado, incluindo --proxy-cert <path-to-cert-file> ao executar o comando az connectedk8s connect.

az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-cert <path-to-cert-file>

O servidor proxy é capaz de alcançar os pontos de extremidade de rede necessários?

Examine os requisitos de rede e verifique se nenhum ponto de extremidade necessário está bloqueado.

O servidor proxy só está usando HTTP?

Se o servidor proxy usar apenas HTTP, você poderá usar proxy-http para ambos os parâmetros.

Se o servidor proxy estiver configurado com HTTP e HTTPS, execute o comando az connectedk8s connect com os parâmetros --proxy-https e --proxy-http especificados. Verifique se você está usando --proxy-http para o proxy HTTP e --proxy-https para o proxy HTTPS.

az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-https https://<proxy-server-ip-address>:<port> --proxy-http http://<proxy-server-ip-address>:<port>  

O servidor proxy requer ignorar intervalos para comunicação serviço a serviço?

Se você precisar ignorar intervalos, use --proxy-skip-range <excludedIP>,<excludedCIDR> no comando az connectedk8s connect.

az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-https https://<proxy-server-ip-address>:<port> --proxy-http http://<proxy-server-ip-address>:<port> --proxy-skip-range <excludedIP>,<excludedCIDR>

Todos os pods no namespace azure-arc estão em execução?

Se tudo estiver funcionando corretamente, todos os pods deverão estar no estado Running. Execute kubectl get pods -n azure-arc para confirmar se o estado de algum pod não é Running.

Ainda está tendo problemas?

As etapas acima resolverão muitos problemas comuns de conexão, mas se você ainda não conseguir se conectar com êxito, gere um arquivo de log de solução de problemas e abra uma solicitação de suporte para que possamos investigar o problema mais a fundo.

Para gerar o arquivo de log de solução de problemas, execute o seguinte comando:

az connectedk8s troubleshoot -g <myResourceGroup> -n <myK8sCluster>

Ao criar sua solicitação de suporte, na seção Detalhes adicionais, use a opção Upload de arquivo para carregar o arquivo de log gerado.

Próximas etapas

• Veja mais dicas de solução de problemas para usar o Kubernetes habilitado para Azure Arc.
• Revise o processo para conectar um cluster do Kubernetes existente ao Azure Arc.