Descargar una Image

Después de buscar la image, podemos descargarla al sistema ejecutando el daemon de Docker. Veamos cómo podemos hacerlo.

Preparación

Asegúrate de que el daemon de Docker se esté ejecutando en el host y que se pueda conectar a través del cliente de Docker.

Cómo hacerlo…

Para descargar una image del registry de Docker, puedes ejecutar lo siguiente:

docker image pull [OPTIONS] NAME[:TAG|@DIGEST]

O el comando heredado:

docker pull [OPTIONS] NAME[:TAG|@DIGEST]

El siguiente es un ejemplo de cómo descargar la image ubuntu:

$ docker image pull ubuntu

Diagrama

Cómo funciona…

El comando pull descarga todas las capas del registry de Docker que son necesarias para crear esa image localmente. Veremos detalles sobre las capas en el próximo capítulo.

Hay más…

Los tags de las images agrupan images del mismo tipo. Por ejemplo, CentOS puede tener images con tags como centos6, centos7, y así sucesivamente. Para descargar una image con un tag específico, por ejemplo, ejecuta el siguiente comando:

$ docker image pull centos:centos7

Por defecto, se descarga la image con el tag latest. Para descargar todas las images correspondientes a todos los tags, usa el siguiente comando:

$ docker image pull --all-tags alpine

Desde Docker 1.6 (https://blog.docker.com/2015/04/docker-release-1-6/), podemos construir y referenciar images mediante un nuevo identificador direccionable por contenido llamado digest. Es una característica muy útil cuando queremos trabajar con images específicas, en lugar de tags. Para descargar una image con un digest específico, podemos usar la siguiente sintaxis:

$ docker image pull <image>@sha256:<digest>

El siguiente es un ejemplo de cómo usar el comando anterior:

$ docker image pull nginx@sha256:788fa27763db6d69ad3444e8ba72f947df9e7e163bad7c1f5614f8fd27a311c3

Los digests solo son compatibles con la versión 2 del registry de Docker.

Una vez que se descarga una image, reside en la caché local (almacenamiento), por lo que las descargas posteriores serán muy rápidas. Esta característica desempeña un papel muy importante en la construcción de images de Docker por capas.

Véase también

Consulta la opción help para docker image pull:

$ docker image pull --help