Comandos Esenciales de Docker¶

Esta es una guía de referencia rápida con los comandos más utilizados en el día a día para administrar tus entornos de Docker.

1. Gestión de Contenedores¶

Los contenedores son las instancias en ejecución de tus imágenes. Aquí tienes los comandos básicos para controlar su ciclo de vida:

2. Inspección y Depuración¶

Comandos cruciales para revisar logs, solucionar problemas o interactuar con el interior de una aplicación:

• docker logs <id_o_nombre>: Muestra la salida estándar y de error del contenedor.
• docker logs -f <id_o_nombre>: Sigue los logs en tiempo real (útil para depurar).
• docker exec -it <id_o_nombre> bash: Abre una terminal interactiva (-it) dentro de un contenedor en ejecución (usa sh si no tiene bash).
• docker inspect <id_o_nombre>: Devuelve toda la información detallada en formato JSON (redes, rutas, volúmenes).
• docker stats: Muestra el consumo de CPU, memoria y red de tus contenedores en tiempo real.

3. Gestión de Imágenes¶

Las imágenes son las plantillas que sirven de molde. Con estos comandos puedes administrarlas:

4. Persistencia y Almacenamiento (Volúmenes)¶

Los datos dentro de un contenedor se destruyen cuando este se elimina. Para persistir información utilizamos volúmenes:

• docker volume ls: Lista todos los volúmenes locales creados.
• docker volume create <nombre>: Crea un nuevo espacio de almacenamiento persistente administrado por Docker.
• docker volume rm <nombre>: Elimina un volumen (debe estar desconectado de cualquier contenedor).
• docker run -v mi_data:/data alpine: Monta el volumen mi_data en la ruta interna /data del contenedor.

5. Limpieza del Sistema (Pruning)¶

Docker suele acumular contenedores antiguos, imágenes intermedias y volúmenes huérfanos que consumen mucho espacio en disco.

• docker system prune: Elimina de golpe todos los contenedores detenidos, redes en desuso e imágenes sin etiquetar.
• docker system prune -a --volumes: Limpieza profunda. Borra todo lo anterior más las imágenes que no estén asociadas a ningún contenedor activo y todos los volúmenes huérfanos.

Orquestación con Docker Compose¶

Docker Compose es una herramienta que permite definir y ejecutar aplicaciones multi-contenedor. Utiliza un único archivo YAML (docker-compose.yml) para configurar todos los servicios, redes y volúmenes que tu aplicación necesita, permitiendo levantarlo todo con un solo comando.

1. Ciclo de Vida de la Aplicación¶

Estos comandos controlan todo el ecosistema de contenedores definido en tu archivo de configuración:

2. Gestión y Diagnóstico¶

Comandos esenciales para monitorizar y realizar el mantenimiento de los servicios agrupados:

• docker compose ps: Muestra el estado actual, nombres y puertos de los contenedores gestionados por el archivo de Compose.
• docker compose logs: Centraliza y muestra las salidas de terminal de todos los servicios simultáneamente.
• docker compose logs -f <nombre_servicio>: Sigue en tiempo real los logs de un servicio específico (por ejemplo: docker compose logs -f db).
• docker compose top: Muestra los procesos activos que se están ejecutando dentro de cada uno de los contenedores.

3. Ejecución de Comandos Internos¶

Cuando necesitas interactuar de forma directa con las herramientas internas de un contenedor específico de la pila:

4. Ejemplo Práctico de Estructura (docker-compose.yml)¶

Para que tus comandos tengan efecto, deben ejecutarse en la misma carpeta donde resida tu archivo de configuración. Aquí tienes un diseño estándar para un entorno Web + Base de Datos:

version: '3.8'

services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
    depends_on:
      - db

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: mi_password_segura
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

💡 Equivalencias Rápidas: Docker vs. Docker Compose¶