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

Artigo
09/28/2024

Ao usar um registro de contêiner do Azure, você pode ocasionalmente encontrar problemas. Por exemplo, talvez não seja possível extrair uma imagem de contêiner devido a um problema com o Docker em seu ambiente local. Ou, um problema de rede pode impedi-lo de se conectar ao 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, acessar um registro de destino. Este comando está disponível na CLI do Azure versão 2.0.67 ou posterior. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).

Para obter orientações adicionais sobre solução de problemas do Registro, consulte:

Executar az acr check-health

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

Nota

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.

Verifique apenas o ambiente

Para verificar o daemon 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

Verifique o ambiente e um registro de destino

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

az acr check-health --name myregistry

Verificar o acesso ao registo numa rede virtual

Para verificar as configurações de DNS para rotear para um ponto de extremidade privado, passe o nome da rede virtual ou o ID do recurso. 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

Comunicação de erros

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

Por padrão, o comando para sempre que encontra um erro. Você também pode executar o comando para que ele forneça saída para todas as verificações de integridade, mesmo se forem encontrados erros. Adicione o --ignore-errors parâmetro, conforme mostrado nos exemplos a seguir:

# 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

Verifique se o registo está configurado com quarentena

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

Próximos passos

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.

Consulte as Perguntas frequentes para perguntas frequentes e outros problemas conhecidos sobre o Registro de Contêiner do Azure.

Partilhar via