Compartir a través de

Inserción de la primera imagen en el registro de contenedor de Azure mediante la CLI de Docker

Un registro de contenedor de Azure almacena y administra imágenes privadas de contenedor y otros artefactos, de una forma similar a la que Docker Hub almacena imágenes de contenedor. Puede usar la interfaz de la línea de comandos de Docker (CLI de Docker) para, entre otras, realizar las siguientes operaciones de imágenes de contenedor en el registro de contenedor: iniciar sesión, insertar, extraer, etc.

En los pasos siguientes, se descarga una imagen de Nginx pública, se le asigna una etiqueta para el registro de contenedor de Azure privado, se inserta en el registro y luego se extrae de este.

Requisitos previos

  • Una suscripción a Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
  • Un registro de contenedor de Azure en la suscripción de Azure. Puede crear uno mediante Azure Portal, la CLI de Azure o Azure PowerShell.
  • También debe tener instalado Docker localmente. Docker proporciona paquetes que permiten configurar Docker fácilmente en cualquier sistema macOS, Windows o Linux.

Inicia sesión en el registro de contenedores

Hay varias maneras de autenticarse en el registro de contenedor.

El método recomendado al trabajar en una línea de comandos es mediante el comando az acr login de la CLI de Azure. Para acceder a un registro denominado myregistry, inicie sesión en la CLI de Azure y autentíquese en el registro:

az login
az acr login --name myregistry

También puede iniciar sesión con docker login. Para conocer los procedimientos recomendados para administrar las credenciales de autenticación, consulte la referencia del comando docker login .

Por ejemplo, puede que haya asignado una entidad de servicio al registro para ver un escenario de automatización. Cuando ejecute el comando siguiente, proporcione interactivamente el identificador de aplicación (nombre de usuario) y la contraseña de la entidad de servicio cuando se le solicite:

docker login myregistry.azurecr.io

Sugerencia

Especifique siempre el nombre completo del registro (en minúsculas) cuando se usa docker login y al etiquetar imágenes para insertar en el registro. En los ejemplos de este artículo, el nombre completo es myregistry.azurecr.io.

Extracción de una imagen de Nginx pública

En primer lugar, extraiga una imagen pública de Nginx en el equipo local. En este ejemplo, se extrae la imagen oficial de Nginx.

docker pull nginx

Ejecute el contenedor localmente

Use el comando docker run para iniciar una instancia local del contenedor nginx de forma interactiva (-it) en el puerto 8080. El argumento --rm especifica que el contenedor debe quitarse cuando lo detenga.

docker run -it --rm -p 8080:80 nginx

Vaya a http://localhost:8080 para ver la página web predeterminada que suministra Nginx en el contenedor en ejecución. Debería ver una página similar a la siguiente:

Nginx en un equipo local

Dado que inició el contenedor de forma interactiva con -it, puede ver la salida del servidor Nginx en la línea de comandos después de navegar a él en el explorador.

Para detener y quitar el contenedor, presione Ctrl+C.

Creación de un alias de la imagen

Utilice docker tag para crear un alias de la imagen, con la ruta de acceso completa al registro. Este ejemplo especifica el espacio de nombres samples para evitar el desorden en la raíz del registro.

docker tag nginx myregistry.azurecr.io/samples/nginx

Para obtener más información sobre el etiquetado con espacios de nombres, consulte los procedimientos recomendados de los espacios de nombres del repositorio](container-registry-best-practices.md#repository-namespaces).

Inserción de la imagen en el registro

Ahora que ha etiquetado la imagen con la ruta de acceso completa para el registro privado, puede insertarla en el registro con docker push:

docker push myregistry.azurecr.io/samples/nginx

Extracción de la imagen del registro

Use el comando docker pull para extraer la imagen del registro:

docker pull myregistry.azurecr.io/samples/nginx

Inicie el contenedor de Nginx

Use el comando docker run para ejecutar la imagen que extrajo del registro:

docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx

Vaya a http://localhost:8080 para ver el contenedor en ejecución.

Para detener y quitar el contenedor, presione Ctrl+C.

Retirada de la imagen (opcional)

Si ya no necesita la imagen Nginx, puede eliminarla localmente con el comando docker rmi.

docker rmi myregistry.azurecr.io/samples/nginx

Para quitar imágenes de Azure Container Registry, use az acr repository delete. Por ejemplo, el siguiente comando elimina el manifiesto al que se hace referencia mediante la etiqueta samples/nginx:latest, todos los datos de la capa únicos y todas las demás etiquetas que hacen referencia al manifiesto.

az acr repository delete --name myregistry --image samples/nginx:latest

Pasos siguientes

Ahora que conoce los conceptos básicos, está listo para empezar a usar el registro. Por ejemplo, implemente imágenes de contenedor del Registro en:

  • Last updated on