Docker
Modelado de dependencias, aislamiento y almacenamiento declarativo.
En Compose, services, y representan tres responsabilidades distintas:
networksvolumesservice → cómo se ejecuta un proceso
network → con quién puede comunicarse
volume → qué datos sobreviven a la instanciaUn diseño claro evita el anti-patrón de “todos los services en una sola red con todos los datos montados”. Cada relación debe existir por una necesidad concreta.
Un service describe una unidad lógica:
services:
api:
image: registry.example.com/api@sha256:...
command: ["node", "dist/server.js"]
environment:
PORT: "3000"
networks: [backend, data]Puede incluir:
El service name funciona como identidad DNS dentro de networks compartidas.
Compose puede crear:
project-api-1Aunque el nombre concreto cambie, otros services conectan a api.
Evita:
container_name: apiporque:
Usa:
docker compose exec api ...
docker compose logs apiservices:
proxy:
networks: [public, backend]
api:
networks: [backend, data]
worker:
networks: [data, queue]
db:
networks: [data]
redis:
networks: [queue]
networks:
public:
backend:
internal: true
data:
internal: true
queue:
internal: trueEsta topología expresa flujo:
Una network no reemplaza auth; limita alcance.
Si no declaras networks, Compose crea una default network del proyecto y conecta services.
Es útil para aplicaciones simples, pero en sistemas con distintos niveles de confianza conviene modelar relaciones explícitas.
No declares diez networks si todas contienen los mismos services. El diseño debe aportar aislamiento real.
services:
db:
networks:
data:
aliases:
- postgres
- databaseÚtiles para compatibilidad o migración. Mantén un nombre canónico y retira aliases temporales.
networks:
edge:
external: trueCompose espera que exista. Su lifecycle pertenece a otro sistema o proyecto.
Usos:
Riesgos:
Documenta owner y procedimiento de creación.
services:
db:
volumes:
- db-data:/var/lib/postgresql/data
volumes:
db-data:Compose crea un named volume con prefijo del proyecto.
project_db-dataCambiar project name crea otro volume. Esto explica “mis datos desaparecieron” cuando en realidad se conectó un recurso diferente.
services:
api:
volumes:
- type: volume
source: uploads
target: /app/uploads
read_only: false
- type: bind
source: ./config.yaml
target: /app/config.yaml
read_only: true
- type: tmpfs
target: /tmp
tmpfs:
size: 67108864La sintaxis larga hace visible tipo, lifecycle y permisos.
volumes:
db-data:
external: trueCompose no lo crea ni elimina con down -v. Debe existir.
Útil cuando:
No lo uses para compartir arbitrariamente una database entre stacks.
volumes:
db-data:
labels:
com.nicoo.owner: platform
com.nicoo.purpose: postgresnetworks:
backend:
labels:
com.nicoo.environment: developmentLabels ayudan a inventario y limpieza. No son autorización.
services:
api:
read_only: true
tmpfs:
- /tmp:size=64m,noexec,nosuid
volumes:
- uploads:/app/uploadsDiseña paths escribibles mínimos.
Para volumes, el usuario del container debe tener UID/GID compatibles. Compose no corrige ownership automáticamente.
depends_on expresa relación de arranque; networks expresan reachability. Un service puede depender lógicamente de otro pero no compartir network por error.
A la inversa, compartir network no implica que deba iniciar antes.
docker compose up -d --scale worker=3Cada réplica comparte service name mediante DNS y puede recibir múltiples direcciones.
Diseña:
container_name;Un named volume compartido entre réplicas no garantiza que el workload soporte concurrencia.
services:
proxy:
image: caddy:2
ports:
- "80:80"
- "443:443"
networks: [edge, backend]
volumes:
- proxy-data:/data
api:
image: registry.example.com/api@sha256:...
environment:
DATABASE_HOST: db
REDIS_HOST: redis
networks: [backend, data, queue]
read_only: true
tmpfs:
- /tmp:size=64m,noexec,nosuid
worker:
image: registry.example.com/api@sha256:...
command: ["node", "dist/worker.js"]
networks: [data, queue]
db:
image: postgres:17
networks: [data]
volumes:
- db-data:/var/lib/postgresql/data
redis:
image: redis:8
networks: [queue]
volumes:
proxy-data:
db-data:
networks:
edge:
backend:
internal: true
data:
internal: true
queue:
internal: truedocker compose down -vElimina named volumes del proyecto. Antes:
docker compose config --volumes
docker compose config --networksLas opciones disponibles dependen de versión; docker compose config siempre es la referencia para el modelo resuelto.
down -v;Quita host port fijo o introduce proxy/load balancer.
Amplía reachability y oculta arquitectura.
Rompe escalado y múltiples proyectos.
Los despliegues fallan o se elimina el recurso fuera de Compose.
Puede producir corrupción o acoplamiento.
Crea recursos duplicados y datos “perdidos”.
container_name impide escalar normalmente?external: true?Healthchecks, readiness y depends_on, donde se diferencia un proceso iniciado de un servicio capaz de atender tráfico.