Trabajando con Imágenes Usando APIs

Como se mencionó anteriormente, Docker utiliza internamente la API del motor de Docker para satisfacer todas nuestras necesidades de contenerización. En esta receta, utilizaremos el comando curl y las APIs del motor de Docker para realizar varias operaciones en las imágenes de Docker.

Cómo hacerlo…

En esta receta, examinaremos algunas operaciones de imagen, como se indica a continuación:

1. Para listar imágenes, use la siguiente API:

Aquí hay un ejemplo de la sintaxis anterior:

1. Puede crear una imagen extrayéndola de cualquier registro o archivo tar utilizando la siguiente API:

La API /images/create admite algunas opciones, como se enumeran a continuación, para trabajar con imágenes:

Ahora, veamos algunos ejemplos:

1. Obtenga la imagen cookbook/apache2 de Docker Hub:

$ curl -X POST \
    --unix-socket /var/run/docker.sock \
    http:/images/create?fromImage=cookbook/apache2

1. Obtenga la imagen de WordPress con la etiqueta latest:

1. Cree una imagen a partir del archivo tar:

En este ejemplo, elegimos subir la imagen como un paquete tar desde el host de Docker utilizando la opción --data-binary del comando curl. Aquí, el contenido de myimage.tar se envía al demonio de Docker a través del cuerpo del mensaje HTTP. Si presta atención a la invocación del comando curl, notará la opción -i. Estamos utilizando la opción -i del comando curl para obtener información de encabezado HTTP.

Para eliminar una imagen, use la siguiente API:

Aquí hay un ejemplo de la sintaxis anterior:

$ curl -X DELETE \
           --unix-socket /var/run/docker.sock \
           http:/images/wordpress:latest

Cómo funciona…

En esta receta, realizamos varias operaciones en la imagen de Docker utilizando el comando curl. El comando curl envía nuestra solicitud de API al demonio de Docker como una solicitud de API REST sobre HTTP. El demonio de Docker, a su vez, realizará la acción solicitada en la imagen y responderá con el estado de la acción.

Hay más…

En esta receta, solo cubrimos tres APIs relacionadas con el manejo de imágenes de Docker, pero hay más. La siguiente captura de pantalla enumera todas las APIs /images disponibles:

Ver también

• Cada punto final de API puede tener entradas diferentes para controlar operaciones. Para obtener más detalles, visite la documentación en el sitio web de Docker en https://docs.docker.com/engine/api/latest/.