docker ps
100%

Docker · Lección 4

docker ps

Aprende a listar los contenedores de Docker y a distinguir cuáles están en ejecución y cuáles han terminado.

¿Sigue en marcha el servidor web que iniciaste en Docker? Compruébalo con docker ps. Una imagen de Docker reúne el programa y los archivos que necesita. Un contenedor es una instancia creada a partir de esa imagen. El comando muestra la lista de contenedores en el momento de la consulta.

Listar contenedores en ejecución

De forma predeterminada, docker ps lista los contenedores en ejecución. Los ejemplos muestran unas cuantas columnas de un entorno Docker preparado. Puedes leer la salida sin configurar Docker. Si usas una terminal, escribe el comando que aparece después del prompt $.

$ docker ps
IMAGE         STATUS         NAMES
nginx:alpine  Up 4 minutes   web
nginx:alpine  Up 30 seconds  demo

Si Docker solo imprime los encabezados de las columnas, la lista de contenedores en ejecución está vacía. En ese mismo entorno todavía puede haber contenedores detenidos.

Docker imprime solo los encabezados de las columnas al ejecutar docker ps. ¿Qué puedes deducir?

Leer nombres y estados

Busca primero el contenedor en la columna NAMES. Las dos filas muestran la misma imagen, nginx:alpine, en la columna IMAGE. Localiza web en la última columna y lee STATUS en esa misma fila. Up 4 minutes indica que ese contenedor lleva unos cuatro minutos en ejecución.

¿Qué fila corresponde a un contenedor que lleva unos 30 segundos en ejecución?

Incluir contenedores que han terminado

Si no aparece un contenedor que esperabas ver, prueba con docker ps -a. La opción -a es la abreviatura de --all. Incluye los contenedores detenidos que todavía existen. Este ejemplo añade una tarea preparada llamada preview.

$ docker ps -a
IMAGE         STATUS                         NAMES
nginx:alpine  Up 4 minutes                   web
nginx:alpine  Up 30 seconds                  demo
busybox:1.36  Exited (0) 2 minutes ago       report
busybox:1.36  Exited (1) About a minute ago  preview

Un contenedor ejecuta un programa principal, como un servidor web o un script. Exited indica que ese programa se ha detenido. El número entre paréntesis es su código de salida, el resultado que comunicó al terminar. Cero suele indicar éxito y un código distinto de cero suele indicar un error. La tarea report muestra Exited (0), un resultado normal para una tarea completada correctamente.

Terminal de LabEx con contenedores activos y terminados, report con código 0 y preview con código 1

La captura de LabEx muestra únicamente los nombres y estados de los cuatro contenedores de ejemplo. Los tiempos transcurridos dependen de cuándo ejecutes el comando.

¿Qué fila investigarías por un posible error a partir del código de salida?

Elegir la próxima comprobación

El código de salida orienta la búsqueda. Para saber si preview imprimió un error, escribe su nombre después de docker logs. El comando muestra la salida que Docker recogió de ese contenedor.

$ docker logs preview

Si el servidor web está en marcha, quizá también quieras saber si un visitante puede abrir la página. Ábrela desde el equipo que necesita acceder. Up describe el programa dentro del contenedor. Una solicitud correcta en el navegador confirma que se puede acceder a la página desde el equipo que has usado.

La página se abre en el equipo que ejecuta Docker. Otra persona necesita abrirla desde su equipo. ¿Qué prueba permite saber si puede hacerlo?

Lección completada

Has completado docker ps

Ya puedes usar la lista de contenedores para localizar uno, leer su estado y decidir qué comprobar después.

  • Usar docker ps para listar los contenedores en marcha.

  • Buscar un contenedor por su nombre y leer su estado.

  • Usar docker ps -a para incluir los contenedores terminados.

  • Usar los registros o una solicitud del navegador cuando el estado no aporta información suficiente.

Guarda tu progreso

Crea una cuenta gratuita para guardar esta lección y continuar en cualquier dispositivo.

Crear una cuenta gratuita
Siguiente Lección
Volver a Docker