Verificar o estado de funcionamento de um registo de contentor do Azure

  • Artigo

Ao utilizar um registo de contentor do Azure, pode ocasionalmente encontrar problemas. Por exemplo, poderá não conseguir extrair uma imagem de contentor devido a um problema com o Docker no seu ambiente local. Em alternativa, um problema de rede pode impedi-lo de se ligar ao registo.

Como primeiro passo de diagnóstico, execute o comando az acr check-health para obter informações sobre o estado de funcionamento do ambiente e, opcionalmente, aceder a um registo de destino. Este comando está disponível na versão 2.0.67 ou posterior da CLI do Azure. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).

Para obter orientações adicionais sobre a resolução de problemas do registo, consulte:

Executar az acr check-health

Os exemplos seguintes mostram diferentes formas de executar o az acr check-health comando.

Nota

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

Verificar apenas o ambiente

Para verificar o daemon local do Docker, 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 registo de destino

Para verificar o acesso a um registo, bem como efetuar verificações de ambiente local, transmita o nome de um registo de destino. Por exemplo:

az acr check-health --name myregistry

Verificar o acesso ao registo numa rede virtual

Para verificar as definições de DNS para encaminhar para um ponto final privado, transmita o nome ou o ID de recurso da rede virtual. O ID do recurso é necessário quando a rede virtual está numa subscrição ou grupo de recursos diferente do registo.

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

Relatório de erros

O comando regista as informações para a saída padrão. Se for detetado um problema, este fornece um código de erro e uma descrição. Para obter mais informações sobre os códigos e possíveis soluções, veja a referência de erro.

Por predefinição, o comando para sempre que encontrar um erro. Também pode executar o comando para que forneça a saída para todas as verificações de estado de funcionamento, mesmo que sejam encontrados erros. Adicione o --ignore-errors parâmetro, conforme mostrado nos seguintes exemplos:

# 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

Resultado do 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 registo está configurado com quarentena

Assim que ativar a colocação em quarentena de um registo de contentor, todas as imagens publicadas neste repositório serão colocadas em quarentena. Todas as tentativas de acesso ou solicitação de imagens em quarentena falharão com um erro. Para obter mais informações, consulte Extrair a imagem de quarentena.

Passos seguintes

Para obter detalhes sobre os códigos de erro devolvidos pelo comando az acr check-health , veja a Referência de erros de verificação de estado de funcionamento.

Veja as FAQ sobre as perguntas mais frequentes e outros problemas conhecidos sobre Azure Container Registry.