Docker
Variaciones de entorno, servicios opcionales y ciclo de desarrollo.
Profiles, archivos override y Compose Watch permiten adaptar una aplicación sin duplicar todo el stack.
modelo base estable
+ variación pequeña y explícita
→ configuración efectiva validadaEl riesgo aparece cuando las combinaciones dejan de ser comprensibles. La fuente de verdad operativa es el resultado de docker compose config, no la lectura aislada de un solo archivo.
Un profile activa services opcionales:
services:
api:
image: my-api
adminer:
image: adminer
profiles: [debug]
mailpit:
image: axllent/mailpit
profiles: [development]Uso:
docker compose --profile debug up -d
docker compose --profile development up -dServices sin profile forman parte del modelo normal. Un service con profile no inicia salvo activación o selección explícita según reglas de Compose.
No uses profiles para mantener dos arquitecturas incompatibles dentro del mismo archivo. Si producción y desarrollo son sistemas radicalmente distintos, revisa el diseño.
Un service activo no debe depender accidentalmente de otro desactivado. Valida combinaciones:
docker compose --profile debug configPrueba cada profile soportado en CI. Una configuración que solo funciona cuando alguien recuerda dos flags es frágil.
docker compose \
-f compose.yaml \
-f compose.development.yaml \
up -dEl segundo archivo modifica el modelo base.
compose.yaml:
services:
api:
image: registry.example.com/api@sha256:...
networks: [backend]compose.development.yaml:
services:
api:
build:
context: .
target: development
command: npm run dev
ports:
- "3000:3000"
volumes:
- .:/app
- node-modules:/app/node_modules
volumes:
node-modules:La variación local añade build, hot reload, port y mounts sin copiar database, networks y healthchecks completos.
Maps, listas y valores escalares no siempre se combinan igual. Algunas propiedades se reemplazan; otras se agregan o tienen reglas especiales.
Nunca infieras el resultado solo visualmente:
docker compose \
-f compose.yaml \
-f compose.production.yaml \
configRevisa especialmente:
Un array heredado puede conservar una publicación o mount que pretendías retirar.
Un override saludable contiene solo diferencias:
services:
api:
environment:
LOG_LEVEL: debugUn override que repite 90 % del base inevitablemente diverge.
Define ownership:
services:
api:
image: "${API_IMAGE:?API_IMAGE required}"
environment:
LOG_LEVEL: "${LOG_LEVEL:-info}"La interpolación ocurre antes o durante la resolución del modelo según Compose. No confundas el .env utilizado para interpolar con env_file enviado al container.
Valida valores obligatorios usando sintaxis de error cuando sea apropiado.
Watch observa cambios y ejecuta acciones como sincronizar o reconstruir según configuración y versión.
Ejemplo conceptual:
services:
api:
build:
context: .
target: development
develop:
watch:
- action: sync
path: ./src
target: /app/src
- action: rebuild
path: ./package-lock.jsonFlujo:
cambio en src
→ sync
→ hot reload
cambio en lockfile
→ rebuild
→ nueva image/containerÚtil para:
Necesario cuando cambia:
Sincronizar un lockfile no instala dependencias. Rebuild o una acción explícita debe actualizar el entorno.
Bind mount:
Watch:
node_modules del host;Elige por rendimiento y claridad, no por novedad.
No sincronices:
.git;.env real;node_modules del host;Evita loops donde la app genera un archivo que Watch vuelve a sincronizar y dispara otra acción.
Base:
images, health, networks, volumes y contratosDevelopment:
build target dev + Watch + debug portTest:
profiles de dependencies + volumes efímeros + no ports públicosProduction:
digests + read_only + límites + logging + sin bind mountsValida cada combinación:
docker compose -f compose.yaml -f compose.development.yaml config --quiet
docker compose -f compose.yaml -f compose.production.yaml config --quietProducción publica una database por una lista combinada inesperadamente.
String y lista pueden producir un resultado distinto al esperado.
Un job o herramienta no existe y el error parece de DNS.
Módulos nativos de macOS terminan en Linux.
El output del build está dentro del path observado.
Overrides antiguos dejan de ser válidos y silenciosamente modifican otro campo.
Consecuencia: drift.
Corrección: base + diferencias pequeñas.
Consecuencia: merge e interpolación inesperados.
Consecuencia: stack incompleto por omitir un flag.
Consecuencia: secretos, caches y bajo rendimiento.
Consecuencia: runtime mutable y no trazable.
Corrección: imágenes inmutables.
config --quiet.node_modules del host?Secrets y configuración en Compose, donde la separación declarativa no debe confundirse con un secret manager completo.