Listar Containers

Podemos listar tanto los containers en ejecución como los detenidos.

Preparación

Asegúrate de que el demonio de Docker esté ejecutándose en el host y que se pueda conectar a través del cliente de Docker. También necesitarás algunos containers en ejecución y/o detenidos.

Cómo hacerlo…

Para listar los containers, ejecuta el siguiente comando:

docker container ls [OPTIONS]

O ejecuta el siguiente comando heredado:

docker ps [OPTIONS]

Diagrama

Cómo funciona…

El demonio de Docker examinará los metadatos asociados con los containers y los listará. Por defecto, el comando devuelve lo siguiente:

  • El ID del container

  • La image desde la que fue creado

  • El comando que se ejecutó después de iniciar el container

  • Los detalles sobre cuándo fue creado

  • El estado actual

  • Los puertos que están expuestos desde el container

  • El nombre del container

Hay más…

Para listar tanto los containers en ejecución como los detenidos, usa la opción -a de la siguiente manera:

Diagrama

Para devolver solo los ID de todos los containers, usa la opción -aq de la siguiente manera:

Diagrama

Para mostrar el último container creado, incluyendo los containers que no están en ejecución, ejecuta el siguiente comando:

$ docker container ls -l

Usando la opción --filter/-f de ps, podemos listar containers con etiquetas específicas. Consulta la receta Etiquetado y filtrado de containers en este capítulo para más detalles.

Ver también

Consulta la opción help de docker container ls:

$ docker container ls --help

La documentación en el sitio web de Docker se puede encontrar aquí: https://docs.docker.com/engine/reference/commandline/container_ls/.