Comprobación del mantenimiento de un registro de contenedor de Azure

  • Artículo

Cuando se usa un registro de contenedor de Azure, en ocasiones pueden surgir problemas. Por ejemplo, es posible que no pueda extraer una imagen de contenedor debido a un problema con Docker en su entorno local. O bien, un problema de red podría impedirle conectarse al registro.

Como primer paso de diagnóstico, ejecute el comando az acr check-helth para obtener información sobre el estado del entorno y el acceso opcional a un registro de destino. Este comando está disponible en la CLI de Azure versión 2.0.67 o posterior. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.

Para obtener instrucciones adicionales sobre la solución de problemas del registro, consulte:

Ejecución del comando az acr check-health

Los ejemplos siguientes muestran distintas formas de ejecutar el comando az acr check-health.

Nota:

Si el comando se ejecuta en Azure Cloud Shell, no se comprueba el entorno local. Sin embargo, puede comprobar el acceso a un registro de destino.

Comprobación solo del entorno

Para comprobar el demonio de Docker local, la versión de la CLI y la configuración de cliente de Helm, ejecute el comando sin parámetros adicionales:

az acr check-health

Comprobación del entorno y de un registro de destino

Para comprobar el acceso a un registro, así como realizar comprobaciones del entorno local, pase el nombre de un registro de destino. Por ejemplo:

az acr check-health --name myregistry

Comprobación del acceso al Registro en una red virtual

Para comprobar la configuración de DNS a fin de enrutar a un punto de conexión privado, pase el nombre o el identificador de recurso de la red virtual. El identificador de recurso es necesario cuando la red virtual está en una suscripción o un grupo de recursos diferente al del registro.

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

Notificación de errores

El comando registra información en la salida estándar. Si se detecta un problema, proporciona un código de error y una descripción. Para obtener más información acerca de los códigos y posibles soluciones, consulte la referencia del error.

De forma predeterminada, el comando se detiene cuando encuentra un error. También puede ejecutar el comando para que proporcione la salida de todas las comprobaciones de mantenimiento, incluso si se encuentran errores. Agregue el parámetro --ignore-errors como se muestra en los ejemplos siguientes:

# 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

Salida del ejemplo:

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

Comprobación de si el registro está configurado con cuarentena

Una vez que habilite que un registro de contenedor se ponga en cuarentena, todas las imágenes que publique en este repositorio se pondrán en cuarentena. Los intentos de acceder o extraer imágenes en cuarentena producirán un error. Para obtener más información, consulte Extracción de la imagen en cuarentena.

Pasos siguientes

Para obtener más información sobre los códigos de error que devuelve el comando az acr check-health, consulte la referencia de errores de la comprobación de mantenimiento.

Vea las preguntas más frecuentes para conocer las preguntas más habituales y otros problemas conocidos sobre Azure Container Registry.