chore(docker): optimise image size #12

New issue

Closed

opened 2026-08-23 20:59:53 +02:00 by vmruiz · 1 comment

vmruiz commented

2026-08-23 20:59:53 +02:00

Owner

Problema

La imagen actual (Dockerfile en main) pesa más de lo necesario:

Base + ffmpeg por apt: python:3.12-slim + apt-get install ffmpeg arrastra decenas de paquetes (estimado ~150-250 MB extra instalados). Hay que medirlo, pero es casi seguro el mayor contribuidor.
Sin .dockerignore: COPY . /app manda al contexto y a la imagen .git, tests/, caches de worktree, etc. → capas más grandes y builds más lentos.
Una sola etapa: la imagen final contiene las herramientas de pip/setuptools y restos del proceso de instalación, no solo el runtime.

Afecta tanto a la imagen de prod como a las de preview dev (telegramarr:dev-<id>-<sha>, una pila por rama en el runner), donde el espacio se multiplica.

Propuesta

Añadir .dockerignore (.git, tests/, __pycache__/, .venv/, docs, etc.).
Build multi-stage: instalar deps en un stage builder y copiar solo el venv/site-packages al stage final.
Evaluar alternativas a ffmpeg de apt: binario estático o copiar solo los binarios necesarios desde un stage dedicado. Si se queda apt, dejarlo documentado con su coste medido.
Valorar uv sync --frozen --no-dev (el repo ya usa uv): instalación reproducible y más rápida que pip install ..
Mantener compatibilidad: ffmpeg tiene que seguir operativo en el contenedor worker (descargas/media).

Criterios de aceptación

Tamaño antes/después medido con docker images y anotado en la PR
Reducción significativa (objetivo inicial >=30%, ajustable tras medir)
CI verde (salvo los 3 tests conocidos que requieren Redis)
Preview dev desplegado y funcional
El worker sigue pudiendo procesar media (ffmpeg operativo)

## Problema La imagen actual (`Dockerfile` en `main`) pesa más de lo necesario: - **Base + ffmpeg por apt**: `python:3.12-slim` + `apt-get install ffmpeg` arrastra decenas de paquetes (estimado ~150-250 MB extra instalados). Hay que medirlo, pero es casi seguro el mayor contribuidor. - **Sin `.dockerignore`**: `COPY . /app` manda al contexto y a la imagen `.git`, `tests/`, caches de worktree, etc. → capas más grandes y builds más lentos. - **Una sola etapa**: la imagen final contiene las herramientas de pip/setuptools y restos del proceso de instalación, no solo el runtime. Afecta tanto a la imagen de prod como a las de preview dev (`telegramarr:dev-<id>-<sha>`, una pila por rama en el runner), donde el espacio se multiplica. ## Propuesta 1. Añadir `.dockerignore` (`.git`, `tests/`, `__pycache__/`, `.venv/`, docs, etc.). 2. Build multi-stage: instalar deps en un stage *builder* y copiar solo el venv/site-packages al stage final. 3. Evaluar alternativas a ffmpeg de apt: binario estático o copiar solo los binarios necesarios desde un stage dedicado. Si se queda apt, dejarlo documentado con su coste medido. 4. Valorar `uv sync --frozen --no-dev` (el repo ya usa uv): instalación reproducible y más rápida que `pip install .`. 5. Mantener compatibilidad: ffmpeg tiene que seguir operativo en el contenedor *worker* (descargas/media). ## Criterios de aceptación - [ ] Tamaño antes/después medido con `docker images` y anotado en la PR - [ ] Reducción significativa (objetivo inicial >=30%, ajustable tras medir) - [ ] CI verde (salvo los 3 tests conocidos que requieren Redis) - [ ] Preview dev desplegado y funcional - [ ] El worker sigue pudiendo procesar media (ffmpeg operativo)

vmruiz referenced this issue from a commit

2026-08-23 21:39:11 +02:00

chore(docker): multi-stage build + static ffmpeg to shrink image (refs #12)

vmruiz referenced this issue from a pull request that will close it,

2026-08-23 21:39:32 +02:00

chore(docker): multi-stage build + static ffmpeg to shrink image (refs #12) #13

forgejo-actions commented

2026-08-23 21:41:13 +02:00

Branch preview deployed by CI.

Branch: chore/docker-image-size
Commit: 6337924a340f4e99a7d100768675bab454ab4683
Endpoint: https://telegramarr-e2bdf32c5.celor.es/

Auto-generated by .forgejo/workflows/dev-deploy.yml.

Branch preview deployed by CI. - Branch: `chore/docker-image-size` - Commit: `6337924a340f4e99a7d100768675bab454ab4683` - Endpoint: https://telegramarr-e2bdf32c5.celor.es/ _Auto-generated by `.forgejo/workflows/dev-deploy.yml`._

vmruiz referenced this issue from a commit

2026-08-23 22:10:04 +02:00

chore(docker): drop unused ffprobe binary (-124MB) (refs #12)

vmruiz closed this issue

2026-08-23 22:12:55 +02:00

vmruiz referenced this issue from a commit

2026-08-23 22:12:56 +02:00

Merge pull request 'chore(docker): multi-stage build + static ffmpeg to shrink image (refs #12)' (#13) from chore/docker-image-size into main