De status van een Azure-containerregister controleren

Artikel
09/28/2024

Wanneer u een Azure-containerregister gebruikt, kunnen er soms problemen optreden. U kunt bijvoorbeeld geen containerinstallatiekopie ophalen vanwege een probleem met Docker in uw lokale omgeving. Een netwerkprobleem kan ook verhinderen dat u verbinding maakt met het register.

Voer als eerste diagnostische stap de opdracht az acr check-health uit om informatie over de status van de omgeving op te halen en eventueel toegang te krijgen tot een doelregister. Deze opdracht is beschikbaar in Azure CLI versie 2.0.67 of hoger. Als u Azure CLI 2.0 wilt installeren of upgraden, raadpleegt u Azure CLI 2.0 installeren.

Zie voor aanvullende richtlijnen voor het oplossen van problemen met het register:

Az acr check-health uitvoeren

In de volgende voorbeelden ziet u verschillende manieren om de az acr check-health opdracht uit te voeren.

Notitie

Als u de opdracht uitvoert in Azure Cloud Shell, wordt de lokale omgeving niet gecontroleerd. U kunt echter de toegang tot een doelregister controleren.

Alleen de omgeving controleren

Als u de lokale Docker-daemon, CLI-versie en Helm-clientconfiguratie wilt controleren, voert u de opdracht uit zonder extra parameters:

az acr check-health

De omgeving en een doelregister controleren

Als u de toegang tot een register wilt controleren en lokale omgevingscontroles wilt uitvoeren, geeft u de naam van een doelregister door. Voorbeeld:

az acr check-health --name myregistry

Registertoegang in een virtueel netwerk controleren

Als u de DNS-instellingen wilt controleren om naar een privé-eindpunt te routeren, geeft u de naam of resource-id van het virtuele netwerk door. De resource-id is vereist wanneer het virtuele netwerk zich in een ander abonnement of een andere resourcegroep bevindt dan het register.

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

Foutrapportage

De opdracht registreert informatie naar de standaarduitvoer. Als er een probleem wordt gedetecteerd, bevat het een foutcode en beschrijving. Zie de foutreferentie voor meer informatie over de codes en mogelijke oplossingen.

Standaard stopt de opdracht wanneer er een fout wordt gevonden. U kunt de opdracht ook uitvoeren zodat deze uitvoer biedt voor alle statuscontroles, zelfs als er fouten worden gevonden. Voeg de --ignore-errors parameter toe, zoals wordt weergegeven in de volgende voorbeelden:

# 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

Voorbeelduitvoer:

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

Controleren of het register is geconfigureerd met quarantaine

Zodra u een containerregister in quarantaine hebt geplaatst, wordt elke installatiekopieën die u naar deze opslagplaats publiceert, in quarantaine geplaatst. Pogingen om in quarantaine geplaatste installatiekopieën te openen of op te halen, mislukken met een fout. Zie de quarantaine-installatiekopie ophalen voor meer informatie.

Volgende stappen

Zie de foutverwijzing voor statuscontrole voor meer informatie over foutcodes die worden geretourneerd door de opdracht az acr check-health.

Zie de veelgestelde vragen over veelgestelde vragen en andere bekende problemen over Azure Container Registry.

Delen via