Realizar operaciones de contenedores utilizando APIs

En la receta anterior, lanzamos un contenedor y ejecutamos un comando dentro del contenedor utilizando las APIs /create, /attach y /start. En esta receta, realizamos algunas operaciones más en el contenedor.

Cómo hacerlo…

En esta receta, examinaremos algunas operaciones de contenedores:

  1. Para listar contenedores, utilice la siguiente API:

Diagrama

Aquí hay algunos ejemplos:

  • Aquí está cómo obtener todos los contenedores en ejecución:
$ curl --unix-socket /var/run/docker.sock \
           http:/containers/json
  • Aquí está cómo obtener todos los contenedores en ejecución, incluyendo los detenidos:
$ curl --unix-socket /var/run/docker.sock \
           http:/containers/json?all=1
  1. Para inspeccionar un contenedor, utilice la siguiente API:

Diagrama

Aquí hay un ejemplo de inspeccionar un contenedor 591ab8ac2650:

$ curl --unix-socket /var/run/docker.sock \
         http:/containers/591ab8ac2650/json
  1. Para obtener la lista de procesos en ejecución dentro de un contenedor, utilice la siguiente API:

Diagrama

Aquí hay un ejemplo de listar los procesos en ejecución dentro del contenedor 591ab8ac2650:

$ curl --unix-socket /var/run/docker.sock \
         http:/containers/591ab8ac2650/top
  1. Para obtener las estadísticas de uso de recursos de un contenedor, utilice la siguiente API:

Diagrama

Aquí hay un ejemplo de obtener las estadísticas de uso de recursos para el contenedor 591ab8ac2650:

$ curl --unix-socket /var/run/docker.sock \
         http:/containers/591ab8ac2650/stats

De forma predeterminada, esta API transmite las estadísticas de uso de recursos. Sin embargo, puede deshabilitar la transmisión utilizando el parámetro stream, como se muestra aquí:

$ curl --unix-socket /var/run/docker.sock \
         http:/containers/591ab8ac2650/stats?stream=0

Cómo funciona…

Cuando nos conectamos con el motor de Docker utilizando las APIs descritas en esta receta, el motor de Docker recopilaría la información relevante de su fuente de datos y la enviaría de regreso al cliente.

Ver también

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