Conceptos 05 - Comandos Docker

Todos los comandos que aparecen en las lecturas prácticas del módulo, organizados por función. Seleccione cualquier comando de un grupo para ver un ejemplo de uso.

• 2 partes
• 14 grupos de comandos
• 3 simuladores
• Autoevaluación final

1. 1Configuración
2. 2Imágenes
3. 3Contenedores
4. 4Listado
5. 5Ciclo de vida
6. 6exec · attach
7. 7Limpieza
8. 8Ayuda
9. 9Verificación
10. 10Opciones
11. 11Volúmenes
12. 12Logs
13. 13Prune
14. 14Host
15. ✓Repaso

1/14Configuración

Parte 1

Administración básica de Docker

01

Concepto 1 de 14

Configuración

Preparar el usuario para ejecutar Docker sin sudo.

sudo usermod -aG docker $USER

Agrega el usuario actual al grupo docker para evitar usar sudo.

$ sudo usermod -aG docker $USER# Cerrar sesión y volver a iniciar para aplicar$ groupsuser sudo docker

Idea clave

Se ejecuta una sola vez después de instalar Docker. Requiere cerrar sesión y volver a entrar para que el cambio tome efecto.

SiguienteImágenes→

02

Concepto 2 de 14

Imágenes

Descargar, listar y eliminar imágenes locales.

docker pull <imagen>docker imagesdocker rmi <imagen>

Descarga una imagen desde Docker Hub.

$ docker pull nginx:alpineStatus: Downloaded newer image for nginx:alpine

Lista las imágenes locales. Equivalente a docker image ls.

$ docker imagesREPOSITORY  TAG     IMAGE ID      SIZEnginx       alpine  f7a8b9c0d1e2  43MB

Elimina una imagen local. Equivalente a docker image rm.

$ docker rmi nginx:alpineUntagged: nginx:alpine

Idea clave

Estos comandos trabajan sobre el almacenamiento local de imágenes: pull agrega, images lista y rmi elimina. Cada uno tiene un equivalente en la forma docker image ....

SiguienteContenedores→

03

Concepto 3 de 14

Contenedores

Crear e iniciar contenedores en primer plano, en modo interactivo o en segundo plano.

docker run <imagen>docker run --name <n> -it <img> shdocker run -it <imagen> <comando>docker run -d <imagen>

Crea e inicia un contenedor en primer plano.

$ docker run nginx:alpineready for connections on port 80

Inicia un contenedor interactivo con nombre y terminal.

$ docker run --name test -it alpine sh/ # echo "dentro del contenedor"/ # exit

Ejecuta un comando específico en modo interactivo.

$ docker run -it python:3.12 pythonPython 3.12.0>>> print("hola")

Inicia en modo desacoplado, en segundo plano.

$ docker run -d nginx:alpinea3f7c9e2b1d0...

Idea clave

docker run siempre crea un contenedor nuevo y lo inicia. Las flags deciden cómo: en primer plano, con una terminal interactiva (-it) o en segundo plano (-d).

SiguienteInspección y listado→

04

Concepto 4 de 14

Inspección y listado

Ver qué contenedores están en ejecución y cuáles están detenidos.

docker psdocker ps -a

Lista contenedores en ejecución.

$ docker psCONTAINER ID  IMAGE         STATUS     NAMESb8e2a1c3d4f5  nginx:alpine  Up 2 min   web

Incluye contenedores detenidos.

$ docker ps -aCONTAINER ID  IMAGE          STATUS                    NAMESb8e2a1c3d4f5  nginx:alpine   Up 5 min                  webc9d0e1f2a3b4  alpine         Exited (0) 3 min ago      test

Idea clave

docker ps muestra solo los contenedores en ejecución. Un contenedor detenido sigue existiendo y solo aparece con -a.

SiguienteControl del ciclo de vida→

05

Concepto 5 de 14

Control del ciclo de vida

Detener, volver a iniciar y eliminar contenedores.

docker stop <contenedor>docker start <contenedor>docker rm <contenedor>

Detiene el contenedor de forma controlada.

$ docker stop webweb

Reinicia un contenedor detenido.

$ docker start webweb

Elimina un contenedor detenido.

$ docker rm testtest

Idea clave

stop y start actúan sobre el mismo contenedor, que conserva su configuración y su capa de escritura. rm lo elimina de forma definitiva.

SiguienteEjecución en contenedores→

06

Concepto 6 de 14

Ejecución en contenedores

Ejecutar comandos dentro de un contenedor activo o conectarse a su salida.

docker exec <cont> <cmd>docker attach <contenedor>

Ejecuta un comando dentro de un contenedor activo.

$ docker exec web cat /etc/hostnameb8e2a1c3d4f5

Conecta la terminal a la salida estándar del contenedor.

Ctrl+C puede detener el contenedor. Use Ctrl+P, Ctrl+Q para desconectar sin detenerlo. Prefiera exec para depuración.

Idea clave

exec lanza un proceso nuevo dentro de un contenedor activo; attach se conecta a su proceso principal. Por eso exec es la opción segura para inspeccionar.

SiguienteLimpieza→

07

Concepto 7 de 14

Limpieza

Encontrar y eliminar contenedores finalizados, imágenes huérfanas y recursos sin uso.

docker ps -a -f status=exiteddocker rm $(docker ps -aq -f status=exited)docker image prunedocker system prunedocker system df

Filtra contenedores finalizados.

$ docker ps -a -f status=exitedCONTAINER ID  IMAGE   STATUS                  NAMESc9d0e1f2a3b4  alpine  Exited (0) 5 min ago    test

Elimina todos los contenedores finalizados en una sola operación.

El subcomando $() ejecuta primero el listado y pasa los IDs como argumento a docker rm.

Elimina imágenes huérfanas.

$ docker image pruneTotal reclaimed space: 420MB

Elimina contenedores detenidos, redes huérfanas e imágenes sin uso.

Precaución. Operación destructiva. Agregue --volumes para incluir volúmenes huérfanos. Revise con docker system df antes de ejecutar.

Muestra uso de disco por tipo de recurso Docker.

$ docker system dfTYPE         TOTAL  ACTIVE  SIZE     RECLAIMABLEImages       5      2       1.2GB    820MB (68%)Containers   3      1       12.5MB   10MB (80%)

Idea clave

Antes de borrar, liste: el mismo filtro que muestra los contenedores finalizados sirve para eliminarlos. Los comandos prune son destructivos y no se pueden deshacer.

SiguienteAyuda→

08

Concepto 8 de 14

Ayuda

Consultar las opciones disponibles de cualquier comando Docker.

docker <comando> --help

Muestra las opciones disponibles de cualquier comando Docker.

$ docker run --helpUsage:  docker run [OPTIONS] IMAGE [COMMAND]-d          Run container in background-p          Publish a container's port--name      Assign a name to the container...

Idea clave

Cualquier comando de Docker acepta --help. Es la referencia más rápida para recordar una flag sin salir de la terminal.

SiguienteVerificación inicial→

Parte 2

docker run en profundidad

09

Concepto 9 de 14

Verificación inicial

Confirmar que Docker está instalado y que el daemon responde.

docker --versiondocker ps

Confirma la versión instalada de Docker.

$ docker --versionDocker version 27.1.0, build abcdef0

Verifica que el daemon esté activo.

Si falla con "Cannot connect to the Docker daemon", el servicio no está corriendo.

Idea clave

docker --version solo consulta el cliente. docker ps necesita hablar con el daemon, por eso sirve para confirmar que el servicio está activo.

SiguienteEjecución con opciones→

10

Concepto 10 de 14

Ejecución con opciones

Combinar puertos, nombres, volúmenes, variables de entorno y modo interactivo en docker run.

docker run -p 8080:80 --name web httpddocker run --rm -p 8080:80 <imagen>docker run -d -v <vol> <imagen>docker run -d --tmpfs <ruta> <imagen>docker run -d -e VAR=valor <imagen>docker run --env-file .env <imagen>docker run -it <imagen> /bin/bash

Mapeo de puertos con nombre asignado.

$ docker run -p 8080:80 --name servidor-web httpdAH00558: httpd: listening on port 80

Contenedor efímero que se elimina al detenerse.

La flag --rm evita acumular contenedores detenidos. Útil para pruebas rápidas.

Ejecución con volumen para persistencia.

$ docker run -d -v pgdata:/var/lib/postgresql/data postgres:17f7a8b9c0d1e2...

Monta un sistema de archivos temporal en memoria.

Los datos en tmpfs se pierden al detener el contenedor. Útil para datos temporales de alto rendimiento.

Inyecta variables de entorno al contenedor.

$ docker run -d -p 5432:5432 \-e POSTGRES_PASSWORD=secret \-v pgdata:/var/lib/postgresql/data \--name db postgres:17

Carga variables desde un archivo .env.

Evita exponer credenciales en el historial del shell. Recuerde agregar .env a .gitignore.

Terminal interactiva para exploración.

$ docker run -it ubuntu:24.04 /bin/bashroot@c4a1b2e3:/# cat /etc/os-release

Activa y desactiva flags sobre la misma orden con postgres:17 y observa cómo cambia el resultado.

Flags de docker run

-d--rm--name db-p 5432:5432-e POSTGRES_PASSWORD=secret-v pgdata:/var/lib/postgresql/data

Idea clave

Cada flag de docker run resuelve una necesidad distinta: -p publica puertos, -v persiste datos, -e configura y --rm evita acumular contenedores. Se combinan en una sola orden.

SiguienteVolúmenes→

11

Concepto 11 de 14

Volúmenes

Crear, inspeccionar y eliminar los volúmenes que persisten datos fuera del contenedor.

docker volume lsdocker volume inspect <vol>docker volume create <vol>docker volume rm <vol>docker volume prune

Lista los volúmenes gestionados por Docker.

$ docker volume lsDRIVER  VOLUME NAMElocal   pgdata

Muestra detalles del volumen en formato JSON.

$ docker volume inspect pgdata"Mountpoint": "/var/lib/docker/volumes/pgdata/_data"

Crea un volumen nombrado.

$ docker volume create appdataappdata

Elimina un volumen específico.

Precaución. Los datos del volumen se pierden de forma irreversible.

Elimina todos los volúmenes no utilizados.

$ docker volume pruneTotal reclaimed space: 256MB

Elige dónde se guardan los datos de /data, escribe algo y comprueba qué sobrevive al reinicio y a la recreación del contenedor.

Sin volumenVolumentmpfs

Contenedor #1

/datacapa de escrituravacío

Volumen appdata

vacío

Escribir datosstop + startrm + run nuevo

Escribe datos en /data y luego prueba qué sobrevive.

Idea clave

Un volumen vive fuera del contenedor: sobrevive a docker rm y a la creación de contenedores nuevos, y solo se pierde cuando se elimina explícitamente.

SiguienteInspección y logs→

12

Concepto 12 de 14

Inspección y logs

Revisar configuración, salida, puertos y eventos de los contenedores.

docker inspect <objeto>docker logs <contenedor>docker logs -f <contenedor>docker logs --tail N <cont>docker logs -t <contenedor>docker port <contenedor>docker events

Información detallada en JSON de cualquier objeto Docker.

$ docker inspect db > salida.json$ docker inspect db | jq '.[0].NetworkSettings.IPAddress'"172.17.0.3"

Muestra la salida acumulada del contenedor.

$ docker logs dbLOG: database system is ready to accept connections

Sigue los logs en tiempo real.

Combine flags: docker logs -f --tail 50 -t db muestra las últimas 50 líneas con timestamps y sigue en vivo.

Limita la salida a las últimas N líneas.

$ docker logs --tail 5 db

Incluye timestamp en cada línea de log.

$ docker logs -t db2025-01-15T10:30:01Z LOG: ready

Muestra los mapeos de puertos del contenedor.

$ docker port db5432/tcp -> 0.0.0.0:5432

Stream de eventos del daemon Docker en tiempo real.

Útil para depuración avanzada. Muestra eventos de contenedores, imágenes, redes y volúmenes. Ctrl+C para salir.

Idea clave

inspect describe cómo está configurado un contenedor; logs muestra lo que escribe su proceso; port y events completan el diagnóstico.

SiguienteLimpieza completa→

13

Concepto 13 de 14

Limpieza completa

Los comandos prune y su alcance, del más específico al más amplio.

docker container prunedocker image prune -adocker network prunedocker system prune -a --volumesdocker system df

Elimina todos los contenedores detenidos.

$ docker container pruneTotal reclaimed space: 10MB

Elimina todas las imágenes sin contenedores asociados.

Precaución. Con -a elimina también imágenes con tag pero sin contenedores que las usen. Más agresivo que sin flag.

Elimina redes no utilizadas.

$ docker network pruneDeleted Networks: mynet

Limpieza total: contenedores, imágenes, redes y volúmenes.

Precaución. Máximo nivel de limpieza. Elimina todo lo no utilizado activamente, incluyendo datos persistentes en volúmenes. Use con precaución.

Revise el uso de disco antes y después de limpiar.

Ejecute antes de cualquier prune para saber qué espacio es recuperable.

Elige un comando de limpieza y observa qué recursos de un sistema de ejemplo elimina y cuáles conserva.

docker container prunedocker image prunedocker image prune -adocker network prunedocker volume prunedocker system prunedocker system prune -a --volumes

• ContenedorwebEn ejecución
• ContenedortestDetenido
• Imagennginx:alpineUsada por web
• ImagenalpineUsada por test (detenido)
• Imagenpython:3.12Con tag, sin contenedores
• Imagen<none>:<none>Huérfana (dangling)
• RedbridgePredeterminada
• RedmynetSin contenedores
• VolumenpgdataNombrado, sin uso
• Volumen3f9c1e…Anónimo, sin uso
• Cachébuild cacheSin uso

Comportamiento de Docker Engine 23 o posterior. Inventario de ejemplo.

Idea clave

Cada prune tiene un alcance distinto. Revise primero con docker system df y elija el comando más específico que resuelva el problema.

SiguienteSistema del host→

14

Concepto 14 de 14

Sistema del host

Diagnosticar en el host los puertos ocupados que impiden publicar un contenedor.

sudo lsof -i :5432sudo netstat -tulpn | grep <puerto>sudo systemctl stop <servicio>

Identifica qué proceso ocupa un puerto en el host.

$ sudo lsof -i :5432COMMAND  PID     USER  TYPE  NAMEpostgres 1234    pg    IPv4  *:5432

Alternativa para identificar puertos en uso.

Útil cuando Docker falla al publicar un puerto porque ya está ocupado por un servicio local.

Detiene un servicio del host que interfiere con Docker.

$ sudo systemctl stop postgresql# Libera el puerto 5432 para uso de Docker

Idea clave

Si Docker no puede publicar un puerto, probablemente otro proceso del host ya lo ocupa. Identifíquelo con lsof o netstat y deténgalo antes de volver a intentarlo.

SiguienteComprueba lo que aprendiste→

✓

Autoevaluación

Comprueba lo que aprendiste

Cinco preguntas rápidas para verificar las ideas clave de la lectura. Cada respuesta incluye una explicación.

1. 1Después de ejecutar sudo usermod -aG docker $USER, docker sigue pidiendo sudo. ¿Qué falta?

   Reinstalar Docker Engine.Cerrar sesión y volver a entrar para que el cambio de grupo tome efecto.Ejecutar docker system prune.
2. 2docker ps no muestra un contenedor que se creó hace un momento. ¿Qué es lo más probable?

   Que el contenedor se eliminó automáticamente.Que la imagen no se descargó.Que el contenedor está detenido; aparece con docker ps -a.
3. 3Un contenedor de postgres se elimina con docker rm y se crea otro igual. ¿En qué caso se conservan los datos?

   Si el primero se ejecutó con -v pgdata:/var/lib/postgresql/data y el nuevo monta el mismo volumen.Si el primero se ejecutó con --tmpfs.Siempre, porque los datos quedan en la imagen.
4. 4¿Para qué sirve --env-file .env en lugar de varias flags -e?

   Para que las variables se guarden dentro de la imagen.Para evitar exponer credenciales en el historial del shell.Para que el contenedor se elimine al detenerse.
5. 5docker run -p 5432:5432 falla porque el puerto ya está en uso. ¿Qué conviene hacer primero?

   Ejecutar docker system prune -a --volumes.Cambiar la imagen por otra versión de postgres.Identificar el proceso con sudo lsof -i :5432 y detener el servicio que lo ocupa.

0/5 respuestas correctas

Reintentar