Al desarrollar la generación de PDF para un sistema de gestión de almacén con Puppeteer, todo funcionaba perfecto en local. Sin embargo, al desplegar usando el contenedor oficial de Puppeteer, desaparecieron todos los espacios: márgenes, padding y separaciones se comprimieron. La lógica de generación seguía operando, pero el layout quedó roto.
Tras probar múltiples configuraciones, investigar el problema y consultar a varias IA, ninguna opción del contenedor oficial solucionó los problemas de espaciado. Para aislar la causa, construí un contenedor propio con Chromium instalado manualmente y una configuración mínima de Puppeteer. Resultado: los problemas de márgenes desaparecieron por completo. Quedó claro que el fallo estaba ligado al contenedor oficial de Puppeteer y no a Puppeteer en sí.
La solución estable y reproducible consiste en usar una imagen base de Node LTS, instalar Chromium con apt y decirle a Puppeteer que utilice ese binario del sistema. El resto del Dockerfile puede ser un multistage estándar para instalar dependencias y preparar el build de producción.
Pasos clave del Dockerfile fiable para PDF con Puppeteer sin problemas de espaciado:
1. Imagen base node lts y carpeta de trabajo
2. apt get update e instalación de chromium y limpieza de la caché de apt
3. Multistage para npm ci en dev y prod
4. PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true para evitar que Puppeteer descargue su propio Chrome
5. Copia del build final y ejecución con Node
En tiempo de ejecución, indica a Puppeteer qué navegador usar. Ejemplo de configuración en tu código de arranque: utilizar executablePath con la ruta del binario del sistema en Linux, como usr bin chromium, y añadir el flag args con no-sandbox cuando el entorno lo requiera.
Importante no-sandbox reduce la seguridad frente a contenido no confiable. En aplicaciones internas como un WMS, esta concesión suele ser aceptable, aunque siempre conviene evaluar el riesgo según tu contexto de ciberseguridad.
Actualización de Chromium en builds de producción: por defecto Docker cachea capas y no actualizará Chromium en cada build. Para forzar la actualización, ejecuta en tus despliegues críticos el comando docker build -t tu-imagen --no-cache .
Con este enfoque, obtendrás PDFs con márgenes coherentes, tipografías consistentes y un layout predecible entre entornos, evitando discrepancias de rendering que suelen aparecer con contenedores preempaquetados.
En Q2BSTUDIO somos una empresa de desarrollo de software con foco en aplicaciones a medida y software a medida, y podemos integrar una canalización de generación de PDF robusta con Puppeteer dentro de tus microservicios o monolitos, asegurando calidad, observabilidad y costes optimizados. Si buscas una solución de extremo a extremo, desde el backend al front y la orquestación en contenedores, descubre nuestros servicios en desarrollo de aplicaciones a medida.
Además, te ayudamos a desplegar y escalar en la nube con buenas prácticas de seguridad, logging, monitorización y CI CD, tanto en AWS como en Azure. Consulta cómo trabajamos entornos productivos resilientes, autoscaling, almacenamiento y redes en servicios cloud AWS y Azure.
Nuestro equipo también es especialista en inteligencia artificial e ia para empresas, agentes IA para automatización inteligente, servicios inteligencia de negocio con power bi, ciberseguridad y pentesting, y modernización de plataformas. Si necesitas integrar procesamiento de documentos, extracción de datos o workflows de firma y facturación con IA, podemos diseñar pipelines que combinen Puppeteer, OCR y modelos de lenguaje para maximizar precisión y ahorro de tiempo.
Palabras clave para ayudarte a encontrarnos y que reflejan lo que hacemos en el día a día aplicaciones a medida, software a medida, inteligencia artificial, agentes IA, ia para empresas, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, power bi, automatización de procesos y calidad de software. Contáctanos y te proponemos una arquitectura clara, mantenible y lista para crecer.