Verifique a integridade de um registro de contêiner do Azure

Artigo
09/29/2024

Ao usar um registro de contêiner do Azure, ocasionalmente você pode encontrar problemas. Por exemplo, talvez você não consiga efetuar pull de uma imagem de contêiner devido a um problema com o Docker no ambiente local. Ou um problema de rede pode impedir a conexão com o registro.

Como primeira etapa de diagnóstico, execute o comando az acr check-health para obter informações sobre a integridade do ambiente e, opcionalmente, o acesso a um registro de destino. O comando está disponível na CLI do Azure versão 2.0.67 ou posterior. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

Veja mais diretrizes de solução de problemas de registro em:

Executar az acr check-health

Os exemplos a seguir mostram diferentes maneiras de executar o comando az acr check-health.

Observação

Se você executar o comando no Azure Cloud Shell, o ambiente local não será verificado. No entanto, você pode verificar o acesso a um registro de destino.

Verificar apenas o ambiente

Para verificar o daemon do Docker local, a versão da CLI e a configuração do cliente Helm, execute o comando sem parâmetros adicionais:

az acr check-health

Verificar o ambiente e um registro de destino

Para verificar o acesso a um registro e executar verificações do ambiente local, passe o nome de um registro de destino. Por exemplo:

az acr check-health --name myregistry

Verificar o acesso ao registro em uma rede virtual

Para verificar as configurações de DNS a fim de rotear para um ponto de extremidade privado, passe o nome ou a ID do recurso da rede virtual. A ID do recurso é necessária quando a rede virtual está em uma assinatura ou grupo de recursos diferente do Registro.

az acr check-health --name myregistry --vnet myvnet

Relatório de erros

O comando registra as informações na saída padrão. Se um problema for detectado, ele mostrará um código de erro e uma descrição. Para obter mais informações sobre os códigos e as possíveis soluções, consulte a referência de erro.

Por padrão, o comando é interrompido sempre que encontrar um erro. Você também pode executar o comando para que ele gere saída para todas as verificações de integridade, mesmo que sejam encontrados erros. Adicione o parâmetro --ignore-errors conforme nos exemplos abaixo:

# Check environment only
az acr check-health --ignore-errors

# Check environment and target registry; skip confirmation to pull image
az acr check-health --name myregistry --ignore-errors --yes

Saída de exemplo:

az acr check-health --name myregistry --ignore-errors --yes

Docker daemon status: available
Docker version: Docker version 18.09.2, build 6247962
Docker pull of 'mcr.microsoft.com/mcr/hello-world:latest' : OK
ACR CLI version: 2.2.9
Helm version:
Client: &version.Version{SemVer:"v2.14.1", GitCommit:"5270352a09c7e8b6e8c9593002a73535276507c0", GitTreeState:"clean"}
DNS lookup to myregistry.azurecr.io at IP 40.xxx.xxx.162 : OK
Challenge endpoint https://myregistry.azurecr.io/v2/ : OK
Fetch refresh token for registry 'myregistry.azurecr.io' : OK
Fetch access token for registry 'myregistry.azurecr.io' : OK

Verificar se o registro está configurado com quarentena

Depois de habilitar um registro de contêiner a ser colocado em quarentena, todas as imagens publicadas neste repositório serão colocadas em quarentena. Qualquer tentativa de acessar ou efetuar pull de imagens em quarentena falhará com um erro. Para obter mais informações, consulte efetuar pull da imagem de quarentena.

Próximas etapas

Para obter detalhes sobre os códigos de erro retornados pelo comando az acr check-health, consulte a referência de erro de verificação de integridade.

Veja perguntas frequentes e outros problemas conhecidos sobre o Registro de Contêiner do Azure.

Compartilhar via