De status van een Azure-containerregister controleren

  • Artikel

Wanneer u een Azure-containerregister gebruikt, kunnen er af en toe problemen optreden. Het is bijvoorbeeld mogelijk dat u een containerinstallatiekopie niet kunt ophalen vanwege een probleem met Docker in uw lokale omgeving. Het is ook mogelijk dat u vanwege een netwerkprobleem geen verbinding kunt maken met het register.

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

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 aanvullende 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. Bijvoorbeeld:

az acr check-health --name myregistry

Registertoegang in een virtueel netwerk controleren

Als u de DNS-instellingen voor het routeren naar een privé-eindpunt wilt controleren, geeft u de naam of resource-id van het virtuele netwerk op. 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, wordt er een foutcode en beschrijving weergegeven. Zie de foutreferentie voor meer informatie over de codes en mogelijke oplossingen.

Standaard wordt de opdracht gestopt 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 hebt ingeschakeld dat een containerregister in quarantaine wordt 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 pull the quarantine image (De quarantainekopie ophalen) voor meer informatie.

Volgende stappen

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

Zie de veelgestelde vragen voor veelgestelde vragen en andere bekende problemen met betrekking tot Azure Container Registry.