Controllare l'integrità di un registro Azure Container

  • Articolo

Quando si usa un Registro Azure Container, è possibile che si verifichino occasionalmente problemi. Ad esempio, potrebbe non essere possibile eseguire il pull di un'immagine del contenitore a causa di un problema con Docker nell'ambiente locale. In alternativa, un problema di rete potrebbe impedire la connessione al Registro di sistema.

Come primo passaggio di diagnostica, eseguire il comando az acr check-health per ottenere informazioni sull'integrità dell'ambiente e facoltativamente accedere a un Registro di sistema di destinazione. Questo comando è disponibile nell'interfaccia della riga di comando di Azure versione 2.0.67 o successiva. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

Per altre indicazioni sulla risoluzione dei problemi del Registro di sistema, vedere:

Eseguire az acr check-health

Gli esempi seguenti mostrano diversi modi per eseguire il az acr check-health comando.

Nota

Se si esegue il comando in Azure Cloud Shell, l'ambiente locale non viene controllato. È tuttavia possibile controllare l'accesso a un Registro di sistema di destinazione.

Controllare solo l'ambiente

Per controllare il daemon Docker locale, la versione dell'interfaccia della riga di comando e la configurazione client Helm, eseguire il comando senza parametri aggiuntivi:

az acr check-health

Controllare l'ambiente e un Registro di sistema di destinazione

Per controllare l'accesso a un Registro di sistema e eseguire controlli dell'ambiente locale, passare il nome di un Registro di sistema di destinazione. Ad esempio:

az acr check-health --name myregistry

Controllare l'accesso al Registro di sistema in una rete virtuale

Per verificare le impostazioni DNS da instradare a un endpoint privato, passare il nome o l'ID risorsa della rete virtuale. L'ID risorsa è necessario quando la rete virtuale si trova in una sottoscrizione o in un gruppo di risorse diverso rispetto al Registro di sistema.

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

Errore di segnalazione

Il comando registra le informazioni sull'output standard. Se viene rilevato un problema, fornisce un codice di errore e una descrizione. Per altre informazioni sui codici e sulle possibili soluzioni, vedere il riferimento all'errore.

Per impostazione predefinita, il comando si arresta ogni volta che rileva un errore. È anche possibile eseguire il comando in modo che fornisca l'output per tutti i controlli di integrità, anche se vengono trovati errori. Aggiungere il --ignore-errors parametro, come illustrato negli esempi seguenti:

# 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

Output di esempio:

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

Verificare se il Registro di sistema è configurato con la quarantena

Dopo aver abilitato un registro contenitori in quarantena, ogni immagine pubblicata in questo repository verrà in quarantena. Eventuali tentativi di accesso o pull delle immagini in quarantena avranno esito negativo con un errore. Per altre informazioni, vedere eseguire il pull dell'immagine di quarantena.

Passaggi successivi

Per informazioni dettagliate sui codici di errore restituiti dal comando az acr check-health , vedere il riferimento all'errore di controllo integrità.

Vedere le domande frequenti per domande frequenti e altri problemi noti relativi alla Registro Azure Container.