Chuleta de Docker — Comandos y Compose

docker pull node:22-alpine

Descarga una imagen desde un registro.

docker image ls

Lista las imágenes locales con su tamaño.

docker build -t myapp:1.0 .

Construye una imagen a partir del Dockerfile de la carpeta actual.

docker build -t myapp:1.0 -f Dockerfile.prod .

Construye con otro Dockerfile.

docker build --no-cache -t myapp:1.0 .

Reconstruye todas las capas desde cero.

docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/acme/myapp:1.0 --push .

Construye para Intel y ARM (p. ej. Apple Silicon, Graviton) y sube ambas.

docker tag myapp:1.0 ghcr.io/acme/myapp:1.0

Asigna a una imagen un nombre de registro antes de subirla.

docker push ghcr.io/acme/myapp:1.0

Sube una imagen a un registro.

docker history myapp:1.0

Muestra las capas de una imagen y su tamaño.

docker run -d --name web -p 8080:3000 myapp:1.0

Ejecuta en segundo plano y publica el puerto {{cport}} del contenedor en el puerto {{hport}} del host.

docker run --rm -it node:22-alpine sh

Abre una shell interactiva temporal; el contenedor se elimina al salir.

docker run -d --restart unless-stopped --name web myapp:1.0

Se reinicia automáticamente tras fallos y reinicios del sistema.

docker run --env-file .env -e NODE_ENV=production myapp:1.0

Pasa variables de entorno desde un archivo y desde la línea de comandos.

docker run -v app-data:/data myapp:1.0

Monta un volumen con nombre para que los datos sobrevivan a la eliminación del contenedor.

docker run --rm -v "$(pwd)":/app -w /app node:22-alpine npm test

Monta la carpeta actual y ejecuta un comando dentro.

docker run --memory 512m --cpus 1.5 myapp:1.0

Limita la memoria y la CPU.

docker run -d --network app-net --name web myapp:1.0

Conéctalo a una red definida por el usuario para que los contenedores se encuentren por nombre.

docker ps -a

Lista todos los contenedores, incluidos los detenidos.

docker logs -f --tail 100 web

Sigue las últimas 100 líneas del log.

docker exec -it web sh

Abre una shell en un contenedor en ejecución (usa bash si la imagen lo incluye).

docker stop web

Detén de forma ordenada (SIGTERM y, tras 10 s, SIGKILL).

docker restart web

Reinicia un contenedor.

docker cp web:/app/logs ./logs

Copia archivos desde un contenedor (invierte los argumentos para copiar hacia dentro).

docker stats

Uso en tiempo real de CPU, memoria, red y disco de los contenedores en ejecución.

docker inspect -f '{{.State.Health.Status}}' web

Lee un campo de los detalles del contenedor; aquí, el estado del health check.

docker port web

Muestra qué puertos del host apuntan al contenedor.

docker compose up -d

Inicia todos los servicios en segundo plano.

docker compose up -d --build

Reconstruye las imágenes y luego inicia.

docker compose ps

Lista los servicios y su estado.

docker compose logs -f api

Sigue los logs de un servicio.

docker compose exec api sh

Abre una shell en un servicio en ejecución.

docker compose run --rm api npm run migrate

Ejecuta un comando puntual en un contenedor nuevo para un servicio.

docker compose restart api

Reinicia un servicio.

docker compose pull

Descarga las últimas imágenes de todos los servicios.

docker compose config

Valida el archivo e imprime la configuración final combinada.

docker compose -f compose.yml -f compose.prod.yml up -d

Aplica un archivo de sobrescritura sobre el archivo base.

docker compose down

Detiene y elimina contenedores y redes (los volúmenes se conservan).

docker volume ls

Lista los volúmenes.

docker volume inspect app-data

Muestra dónde está almacenado un volumen en el host.

docker run --rm -v app-data:/data -v "$(pwd)":/backup alpine tar czf /backup/app-data.tar.gz -C /data .

Haz una copia de seguridad de un volumen en un .tar.gz en la carpeta actual.

docker network create app-net

Crea una red para contenedores que necesitan comunicarse entre sí.

docker network connect app-net web

Conecta un contenedor en ejecución a una red.

docker system df

Muestra cuánto espacio ocupan imágenes, contenedores, volúmenes y caché de build.

docker builder prune

Elimina la caché de build no utilizada.

docker run --rm -it --entrypoint sh myapp:1.0

Arranca una imagen con una shell en lugar de su comando habitual; útil para imágenes que fallan al iniciar.

docker logs web 2>&1 | grep -i error

Busca en los logs de un contenedor (stdout y stderr).

docker exec web env

Muestra las variables de entorno que realmente ve un contenedor.

docker compose exec api wget -qO- localhost:3000/health

Llama a un endpoint de salud desde dentro del servicio.

docker events --since 10m

Muestra en tiempo real los eventos recientes de Docker: inicios, paradas, cierres por OOM y cambios de salud.