Controllare l'integrità di un Registro Azure Container

Quando si usa un registro Azure Container, occasionalmente possono verificarsi dei 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 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:

• Risolvere i problemi di accesso al registro
• Risolvere i problemi di rete del registro
• Risolvere i problemi relativi alle prestazioni del registro

Eseguire az acr check-health

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

Controllare solo l'ambiente

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

az acr check-health

Controllare l'ambiente e un registro di destinazione

Per controllare l'accesso a un Registro di sistema e eseguire controlli dell'ambiente locale, passare il nome di un registro 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

Segnalazione errori

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 le informazioni di riferimento sull'errore.

Per impostazione predefinita, il comando si arresta ogni volta che rileva un errore. È anche possibile eseguire il comando in modo che fornisca output per tutti i controlli di integrità, anche se vengono rilevati errori. Aggiungere il parametro --ignore-errors, 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

Controllare se il Registro di sistema è configurato con la quarantena

Dopo aver abilitato la quarantena di un registro contenitori, ogni immagine pubblicata in questo repository verrà messa 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 informazioni di riferimento sull'errore di controllo integrità.

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