La orden docker ps nos va a servir para obtener información de los contenedores ya arrancados. La información que nos proporciona va a ser menos exhaustiva que la que podemos obtener con docker inspect pero nos puede ayudar a determinar aspectos como:

• El estado del contenedor (Parado EXITED o Funcionado UP).
• La imagen de la que deriva el contenedor.
• El tamaño actual del contenedor.
• La orden que ejecuta el contenedor al arrancar, lo que se llama el ENTRYPOINT (hablaremos de ello en el capítulo 6).
• El nombre del contenedor, ya sea dado por nosotros o por docker.
• Cuándo fue creado el contenedor.
• Las redirecciones de puertos, en caso de haberlas.

Como muchas de las subórdenes de docker,  ps tiene multitud de opciones (flags) así que para ilustrar su uso vamos a poner ejemplos.

# Mostrar los contenedores que están en ejecución > docker ps # Mostrar todos los contenedores, estén parados o en ejecución (-a o --all) > docker ps -a # Añadir la información del tamaño del contenedor a la información por defecto (-s o --size) > docker ps -a -s # Mostrar información del último contenedor que se ha creado (-l o --latest). Da igual el estado > docker ps -l # Filtar los contenedores de acuerdo a algún criterio usando la opción (-f o --filter) # Filtrado por nombre > docker ps --filter name=servidor_web # Filtrado por puerto. Contenedores que hacen público el puerto 8080 > docker ps --filter publish=8080

Hay más opciones, e incluso podemos formatear la salida usando el flag --format, pero por ahora vamos a quedarnos en con las vistas

Una vez ejecutamos el comando elegido obtendremos una salida similar a la siguiente:

Podemos ver que las filas nos muestran información de cada uno de los contenedores. El tipo de cada información vienen reflejado en las columnas y podemos apreciar que las redirecciones de puertos solo se muestran en aquellos contenedores que están en ejecución (UP).

Los contenedores parados tiene el estado(Status) EXITED.

Si la información que hemos obtenido usando docker ps , que es una información general, no es suficiente para nuestro objetivo, usaremos docker inspect que nos va a dar una información detallada del contenedor que seleccione. Lo podemos hacer de las siguientes formas:

# Por nombre. Por ejemplo: Mostrar información detallada del contenedor cuyo nombre es jenkins > docker inspect jenkins # Por id. Por ejemplo: Mostrar información detallada del contenedor cuyo id es 5e5adf6815bc > docker inspect 5e5adf6815bc

Al ejecutar esto obtendremos una imagen similar a la siguiente:

Esta imagen es una imagen parcial, porque se nos muestra mucha información, está en formato JSON (JavaScript Object Notation) y nos da datos sobre aspectos como:

• El id del contenedor.
• Los puertos abiertos y sus redirecciones
• Los bind mounts y volúmenes usados.
• El tamaño del contenedor
  
• La configuración de red del contenedor.
• El ENTRYPOINT que es lo que se ejecuta al hacer docker run.
• El valor de las variables de entorno.
• Y muchas más cosas....

Adicionalmente podemos formatear la salida usando Go Templates y el flag --format/-f. Una descripción detallada queda fuera de los objetivos de este curso pero vamos a poner varios ejemplos:

# Mostrar la ip del contenedor >  docker inspect --format 'La ip es {{.NetworkSettings.Networks.bridge.IPAddress}}' jenkins La ip es 172.17.0.2 # Mostrar las redirecciones de puertos del contenedor > docker inspect --format 'Las redirecciones de puertos son {{.NetworkSettings.Ports}}' jenkins Las redirecciones de puertos son map[50000/tcp:[{0.0.0.0 50000}] 8080/tcp:[{0.0.0.0 9090}]]

NOTA: Para poder hacer este formateo debemos conocer en profundidad la estructura del código JSON que nos devuelve.

Los dos comandos que hemos visto anteriormente nos dan información relativa al contenedor pero no nos dan información de lo que está pasando dentro del contenedor. Para determinar este tipo de cosas sabemos que en cualquier entorno funcional se utilizan los logs.  Docker también nos proporciona este mecanismo, los cuales, siempre estarán disponibles aunque el contenedor al que pertenezca está parado. La orden docker logs visualiza estos objetos tan útiles

Los podemos hacer de las siguientes formas:

# Por nombre. Por ejemplo: Mostrar los logs del contenedor cuyo nombre es jenkins > docker logs jenkins # Por id. Por ejemplo: Mostrar los logs cuyo id es 5e5adf6815bc > docker logs 5e5adf6815bc

Evidentemente los logs de un contenedor varían mucho de un contenedor a otro. No es lo mismo un log de un contenedor de base de datos que los logs de un servidor web. No obstante  una posible salida, si es un contenedor con jenkins, sería esta:

Como todas las órdenes, docker logs, tiene más opciones cuyo uso vamos a ilustrar con ejemplos:

# Opción -f o --follow . Sigue escuchando la salida que pueden dar los logs del contenedor > docker logs -f jenkins # Opción  --tail 5. Muestra las 5 últimas líneas de los logs del contenedor en cuestión > docker logs --tail 5 jenkins

CONSULTAR LOS LOGS ES DE ESPECIAL UTILIDAD CUANDO NUESTROS CONTENEDORES CON SERVICIOS ESTÁN FALLANDO