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

Se você estiver enfrentando problemas para 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 sua conexão de rede usar um servidor proxy.

Gorjeta

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, certifique-se de fazê-lo antes de começar.

Conexões sem proxy

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

A identidade do Azure tem permissões suficientes?

Revise os pré-requisitos 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?

Certifique-se de que tem a versão mais recente instalada.

Se você conectou seu cluster usando o Azure PowerShell, verifique se está executando a versão mais recente.

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

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

az extension update --name connectedk8s

Se ainda não instalou a extensão, pode fazê-lo 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?

Certifique-se de que os provedores de recursos Microsoft.Kubernetes, Microsoft.KubernetesConfiguration e Microsoft.ExtendedLocation estejam registrados.

Todos os requisitos de rede são atendidos?

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

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

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

Ainda está com 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, em seguida , abra uma solicitação de suporte para que possamos investigar o problema ainda mais.

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 uma máquina, conclua as cinco primeiras etapas do fluxograma sem proxy (por meio do registro do provedor de recursos) para obter as etapas básicas de solução de problemas. Em seguida, se você ainda estiver encontrando problemas, revise o próximo fluxograma para obter etapas adicionais de solução de problemas. Mais detalhes sobre cada etapa são fornecidos abaixo.

A máquina está executando comandos atrás de um servidor proxy?

Se a máquina estiver executando comandos atrás de um servidor proxy, você precisará definir todas as variáveis de ambiente necessárias. Para obter mais informações, consulte 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 só aceita certificados confiáveis?

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

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?

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

O servidor proxy está usando apenas HTTP?

Se o seu servidor proxy usa apenas HTTP, você pode usar proxy-http para ambos os parâmetros.

Se o servidor proxy estiver configurado com HTTP e HTTPS, execute o az connectedk8s connect comando com os --proxy-https parâmetros e --proxy-http especificados. Certifique-se de estar 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 intervalos de pulo para comunicação serviço-a-serviço?

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

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 estão em azure-arc execução?

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

Ainda está com 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, em seguida , abra uma solicitação de suporte para que possamos investigar o problema ainda mais.

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óximos passos

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