HOWTO · Docker
Mostrar contenedores en Docker
Este tutorial demuestra cómo enumerar los contenedores docker que hemos creado en nuestro sistema.
En esta página
Usa la CLI de Docker para listar contenedores y elige las opciones según necesites ver contenedores en ejecución, detenidos, limitar los resultados o mostrar campos concretos. Estos comandos consultan el daemon de Docker seleccionado por el contexto actual. Los ejemplos muestran la sintaxis de los comandos; sus resultados dependen de los contenedores disponibles en ese daemon, por lo que no se muestra una salida fija.
Listar todos los contenedores en ejecución en Docker
Ejecuta docker ps para listar los contenedores que están en ejecución. El comando equivalente es docker container ls:
docker ps
La tabla predeterminada incluye el ID del contenedor, la imagen, el comando de inicio, el tiempo transcurrido desde su creación, el estado, los puertos publicados o expuestos y el nombre. El campo STATUS indica cuánto tiempo lleva en ejecución un contenedor. Las entradas de puertos describen asignaciones o puertos expuestos; por sí solas, no indican si se puede acceder al servicio desde tu máquina.
Usa docker container ls si prefieres la forma que incluye el grupo de comandos. Devuelve el mismo conjunto predeterminado y las mismas columnas que docker ps.
Listar contenedores en ejecución y detenidos en Docker
Añade -a (o --all) para incluir tanto los contenedores detenidos como los que están en ejecución:
docker ps -a
Un contenedor detenido sigue apareciendo con un estado como Exited (0), donde el número es su código de salida. El estado de los contenedores en ejecución empieza por Up. Esta opción cambia los estados que se incluyen; no inicia los contenedores detenidos. Si el daemon no tiene contenedores, la tabla solo muestra el encabezado.
Listar una cantidad específica de contenedores en Docker
Usa -n seguido de una cantidad para mostrar como máximo ese número de los contenedores creados más recientemente, incluidos los de cualquier estado. Por ejemplo, docker container ls -n 2 devuelve como máximo dos contenedores; con esta opción no necesitas -a para incluir contenedores detenidos. La cantidad es un límite máximo, así que pueden aparecer menos filas si hay menos contenedores. Para limitar específicamente los contenedores detenidos, combina la cantidad con --filter "status=exited", por ejemplo: docker ps -n 2 --filter "status=exited".
Listar solo contenedores detenidos con estado de salida en Docker
Filtra por estado para encontrar contenedores detenidos cuyo estado registrado sea de salida:
docker container ls -a --filter "status=exited"
La opción -a incluye los contenedores que no están en ejecución en el conjunto que se examina; después, el filtro de estado selecciona los que tienen el estado de salida. El filtro no incluye otros estados de detención. Los filtros de Docker se pueden combinar; cada condición debe corresponder a los resultados que quieres encontrar.
Listar los contenedores creados más recientemente en Docker
Usa --latest (o -l) para mostrar el único contenedor creado más recientemente:
docker container ls --latest
Esta opción resulta útil cuando necesitas la entrada del contenedor más nuevo, incluso si está detenido. No sirve para solicitar varios contenedores recientes; para indicar una cantidad, usa -n. Si necesitas buscar el más reciente entre todos los estados, docker ps -a --latest deja explícito que se incluyen todos.
Listar los ID de los contenedores en Docker
Añade -q (o --quiet) para mostrar únicamente los ID de los contenedores:
docker container ls -q
Este formato compacto es práctico para pasar los ID a otro comando o guardarlos en una variable de shell. De forma predeterminada, sigue mostrando solo los contenedores en ejecución; añade -a para incluir los detenidos. La salida silenciosa omite los nombres, el estado y los demás campos de la tabla, así que usa el listado normal si necesitas consultar esos detalles.
Listar contenedores junto con sus tamaños en Docker
Añade -s (o --size) para incluir información sobre el tamaño en el listado:
docker container ls -s
La columna SIZE muestra el tamaño de la capa escribible del contenedor y su tamaño virtual. La cifra de la capa escribible representa los cambios realizados en ese contenedor; el tamaño virtual también incluye las capas de imagen que utiliza. Estos valores describen el almacenamiento, no el consumo actual de memoria. Usa un comando o una herramienta de monitorización si necesitas consultar el uso de RAM. Al igual que el listado predeterminado, este comando muestra los contenedores en ejecución, salvo que añadas -a.