Partilhar via

Verificar a conexão com o registro de contêiner

  • Artigo

Este artigo faz parte de uma série. Comece com a visão geral.

Para implantar com êxito aplicativos em contêineres em seu cluster do Serviço Kubernetes do Azure (AKS), é essencial verificar a conectividade entre o cluster e o registro do contêiner. Esta etapa garante que os nós de trabalho tenham as permissões necessárias para extrair as imagens de contêiner necessárias do Registro.

Identificar sintomas

Quando o kubelet executado em um nó de agente cria os contêineres para um pod, um ou mais contêineres podem acabar no estado de espera devido ao ImagePullBackOff erro. ImagePullBackoff é uma mensagem de erro comum no Kubernetes que indica uma falha ao extrair a imagem de contêiner necessária de um registro público ou privado. Vários fatores podem causar esse erro, incluindo problemas de conectividade de rede, um nome de imagem ou tag incorreto, permissões insuficientes ou credenciais ausentes.

A BackOff parte do status significa que o Kubernetes tenta continuamente puxar a imagem com um atraso crescente entre cada tentativa subsequente. O atraso aumenta gradualmente até atingir um limite predeterminado, que normalmente é definido como 300 segundos (5 minutos) no Kubernetes.

É importante verificar novamente a precisão do registro e do nome da imagem. Além disso, certifique-se de que seu cluster AKS tenha as permissões necessárias para extrair imagens do registro de contêiner apropriado.

Atribuições de funções

Quando você anexa um registro de contêiner a um cluster AKS existente, a função AcrPull é atribuída automaticamente sobre o registro à identidade gerenciada do Microsoft Entra associada aos pools de agentes em seu cluster AKS. Para obter mais informações, consulte Autenticar com o registro de contêiner do AKS.

Execute o seguinte comando para recuperar a identidade gerenciada kubelet de um cluster Kubernetes e suas atribuições de função atuais:

# Get the kubelet managed identity.
ASSIGNEE=$(az aks show -g $RESOURCE_GROUP -n $NAME --query identityProfile.kubeletidentity.clientId -o tsv)
az role assignment list --assignee $ASSIGNEE --all -o table

Execute o seguinte comando para atribuir a AcrPull função à identidade gerenciada kubelet:

AZURE_CONTAINER_REGISTRY_ID=$(az acr show --name <container-registry-name> --query id --output tsv)
az role assignment create --assignee $ASSIGNEE --scope $AZURE_CONTAINER_REGISTRY_ID --role acrpull

Solucionar problemas do Registro de Contêiner

As seções a seguir fornecem guias aos quais você pode consultar se encontrar problemas de rede, entrada ou desempenho com um registro de contêiner do Azure.

Solucionar problemas de rede

Se você encontrar problemas relacionados ao acesso a um registro de contêiner do Azure em uma rede virtual ou atrás de um firewall ou servidor proxy, considere as seguintes soluções:

Resolver problemas de início de sessão

Se você encontrar problemas de autenticação e autorização ao entrar em um registro de contêiner do Azure, considere as seguintes soluções:

Solucionar problemas de desempenho

Se você encontrar problemas de desempenho com um registro de contêiner do Azure, considere as seguintes soluções:

Esses guias podem ajudá-lo a garantir uma recuperação de imagem perfeita para seu cluster AKS e garantir o bom funcionamento de suas cargas de trabalho.

Integrar um registro de contêiner de terceiros

Ao usar um registro de contêiner de terceiros, você precisa criar as credenciais apropriadas ImagePullSecret para o registro para que seu cluster AKS possa acessar com segurança as imagens de contêiner. Para obter mais informações, consulte Criar um segredo de pull de imagem. Certifique-se de configurar as permissões e credenciais corretas para que possa verificar a conexão com o registro de contêiner e habilitar seu cluster AKS para extrair com êxito as imagens de contêiner necessárias durante as implantações. Essa prática recomendada ajuda a garantir uma execução suave e confiável de suas cargas de trabalho em contêineres no Kubernetes.

Contribuidores

Este artigo é mantido pela Microsoft. Foi originalmente escrito pelos seguintes contribuidores.

Principais autores:

Para ver perfis não públicos do LinkedIn, inicie sessão no LinkedIn.

Próximos passos