Solucionar problemas comuns no AKS Edge Essentials

Artigo
07/23/2024

Este artigo descreve como encontrar soluções para problemas encontrados ao usar o AKS Edge Essentials. Problemas conhecidos e erros são organizados por área funcional. Você pode usar os links fornecidos neste artigo para encontrar soluções e soluções alternativas para resolvê-los.

Abrir uma solicitação de suporte

Consulte o artigo Obter suporte para obter informações sobre como usar o portal do Azure para obter suporte ou abrir uma solicitação de suporte para o AKS Edge Essentials.

Problemas de implantação

Problema de editor não confiável

Mensagem de erro: "Deseja executar o software deste editor não confiável? ....."

Solução alternativa: atualize sua política de execução do PowerShell para RemoteSigned:

# Get the execution policy on the system
Get-ExecutionPolicy
# Set the execution policy for this process only
if ((Get-ExecutionPolicy) -ne "RemoteSigned") { Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force }

Pouco espaço em disco faz com que as imagens de contêiner armazenadas anteriormente em cache sejam excluídas

Quando o nó fica sem espaço em disco, algumas das imagens pré-carregadas são coletadas pelo containerd runtime. Nesse caso, primeiro libere algum espaço em disco e, em seguida, execute o seguinte comando para extrair as imagens armazenadas em cache novamente:

    Invoke-AksEdgeNodeCommand -NodeType Linux -command "sudo /path/to/script/reimport-ci.sh

Esse script verifica as imagens ausentes e as reimporta conforme necessário.

Conectividade do Azure Arc

Problema: Disconnect-AksEdgeArc não remove os pods do cluster.

Solução alternativa: se os pods não forem limpos, execute os seguintes comandos para limpar manualmente os recursos existentes relacionados ao Azure Arc antes de tentar se reconectar novamente:
```
kubectl delete ns azure-arc
kubectl delete clusterrolebinding azure-arc-operator
kubectl delete secret sh.helm.release.v1.azure-arc.v1
```
Problema: a conectividade do Azure Arc não funciona em um ambiente de proxy.

Solução alternativa: Você pode habilitar as configurações de proxy em todo o sistema seguindo as opções > da Internet Configurações de LAN de conexões>.

Implantações offline

Falha ao obter o certificado nodeagent: Não encontrado

Verifique a configuração do adaptador de rede. Durante a implantação, o AKS Edge Essentials precisa de um adaptador habilitado e com o endereço IP, a sub-rede e o gateway padrão corretos. Esses valores são preenchidos automaticamente em um ambiente DHCP. Se você estiver configurando manualmente, certifique-se de que todos os três estejam definidos. Em muitos casos, o gateway padrão não está definido, o que resulta nesse erro.

Kubernetes

O pod Kube-vip reinicia continuamente

Em alguns cenários, o pod kube-vip faz um loop e reinicia continuamente.

Validação

Para confirmar se o cenário que você está encontrando é o mesmo problema documentado neste artigo, verifique se o pod kube-vip no namespace kube-system tem um alto número de reinicializações executando o seguinte comando:

kubectl get pods –n kube-system

Causa

Existem alguns motivos diferentes pelos quais o pod kube-vip pode estar constantemente reiniciando. Essas causas incluem:

Usando um disco do sistema operacional que não tem suporte com um disco SSD ou um disco SSD premium ao usar uma VM do Azure. Você pode revisar os requisitos de hardware aqui.
A latência do disco é muito alta. Se a latência do disco for maior que 10 ms, isso poderá resultar em tempos limite de solicitação, perda de líder e possível instabilidade do cluster. Você pode revisar os requisitos de hardware para etcd aqui.

Resolução

Para atenuar esse problema, examine sua infraestrutura de armazenamento subjacente para garantir que ela atenda aos requisitos de desempenho do etcd e do AKS Edge Essentials. Além disso, considere usar o armazenamento premium com suporte de SSD ou otimizar sua configuração de armazenamento para desempenho.

Próximas etapas

Visão geral do AKS Edge Essentials

Compartilhar via