Despliegue Automático de Next.js en AWS EC2 con Ansible

Automatizamos despliegues de Next.js con Ansible y GitHub Actions en AWS EC2 para entregas reproducibles, seguras y escalables, gestionando secretos y monitoreo.

19 ago 2025 • 5 min de lectura • Equip Q2BSTUDIO

Inteligencia-Artificial-

¿Cansado de desplegar manualmente cada actualización de tu aplicación Next.js conectándote por SSH, haciendo git pull, ejecutando npm install, compilando y reiniciando procesos? En Q2BSTUDIO entendemos ese dolor y te proponemos una solución automatizada, reproducible y escalable usando Ansible, GitHub Actions y servidores EC2 en AWS. Q2BSTUDIO es una empresa de desarrollo de software a medida especializada en aplicaciones a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y power bi, lista para ayudarte a automatizar despliegues y mejorar la disponibilidad de tus sistemas.

La idea principal es sencilla: en lugar de repetir pasos manuales en cada servidor, centralizas el despliegue en un controlador Ansible que ejecuta un playbook que clona el repositorio, instala dependencias, construye la app y la arranca con un gestor de procesos como PM2. Con esto puedes desplegar en un servidor o en cien con un solo comando.

Beneficios clave ofrecidos por este enfoque: despliegues consistentes, menos errores humanos, escalabilidad sencilla y posibilidad de integrar pruebas y validaciones previas al despliegue. Además, combinando esto con servicios cloud aws o azure puedes añadir balanceadores y escalado automático cuando lo necesites.

Componentes principales de la arquitectura: Ansible Controller en una instancia EC2 que actúa como centro de comando, uno o varios App Servers EC2 donde corre Next.js, y GitHub Actions como disparador CI CD que envía el playbook y ejecuta ansible playbook en el controlador. Q2BSTUDIO puede ayudarte a definir la infraestructura, crear las imágenes AMI y optimizar seguridad y ciberseguridad para proteger llaves SSH y accesos.

Paso 1 poner un EC2 para el controlador: lanzar Amazon Linux 2 o Amazon Linux 2023, instalar python3 y Ansible con pip3. Guardar de forma segura la llave privada que usarán los workflows en GitHub Actions. Paso 2 lanzar los App Servers con Amazon Linux 2023 o similar, abrir puertos SSH y el puerto de la app, y probar SSH desde el controlador para garantizar conectividad segura.

Paso 3 crear el playbook Ansible que realiza las tareas necesarias: comprobar Node.js, instalar git y certificados, crear directorio de la app, clonar el repositorio, instalar Node.js si hace falta, crear swapfile para evitar out of memory durante npm install, instalar dependencias con npm ci cuando exista package lock, ejecutar npm run build y arrancar o reiniciar la aplicación con PM2. El playbook se parametriza con variables como app dir, repo, rama y usuario para facilitar despliegues en diferentes entornos.

Paso 4 probar localmente desde el controlador ejecutando ansible all -i inventory.ini -m ping y luego ansible playbook -i inventory.ini deploy.yml. Verificar que la app responde en https://IP-DEL-SERVIDOR:3000 y que PM2 está gestionando los procesos correctamente.

Paso 5 automatizar con GitHub Actions: crear un workflow que al hacer push a la rama main o por dispatch copie la llave privada segura desde GitHub Secrets, añada los fingerprints de los hosts, suba el playbook y el archivo inventory al controlador y ejecute ansible playbook de forma remota. En los secrets de GitHub añadir ANSIBLE_SSH_PRIVATE_KEY con el contenido de la llave pem, ANSIBLE_HOST con la IP del controlador y ANSIBLE_APP_HOST con la IP del servidor de aplicaciones. Q2BSTUDIO ofrece servicios de consultoría para configurar estos secretos, asegurar las llaves y auditar la seguridad del pipeline como parte de nuestros servicios de ciberseguridad.

Al desplegar con este flujo cada push puede desencadenar un despliegue seguro y reproducible. Si algo falla el playbook y los logs de GitHub Actions permiten diagnosticar rápidamente problemas comunes como SSH connection refused, llaves incorrectas o errores de memoria durante npm install. Para errores de memoria el playbook puede crear un swapfile de 2G y ajustar NODE_OPTIONS para limitar la memoria usada durante la compilación.

Escalado y mejoras: para desplegar en múltiples servidores agregar filas al inventory con app-server-1 app-server-2 etc y Ansible ejecutará las mismas tareas en paralelo. Para producción se recomienda añadir un Application Load Balancer en AWS que distribuya tráfico entre instancias, y considerar despliegues blue green para cero downtime. Q2BSTUDIO puede diseñar soluciones con Docker y ECS o EKS si prefieres contenedores y orquestación, además de integrar monitorización con Datadog o servicios similares dentro de nuestros paquetes de servicios cloud aws y azure.

Variables de entorno y secretos: el playbook puede crear un archivo .env con NODE_ENV production DATABASE_URL y claves de API gestionadas con vaults o secretos en AWS Secrets Manager o Azure Key Vault. En Q2BSTUDIO implementamos prácticas de gestión de secretos y servicios inteligencia de negocio para mantener configuraciones seguras y auditables.

Por qué elegir a Q2BSTUDIO: ofrecemos desarrollo de software a medida y aplicaciones a medida con enfoque en seguridad y escalabilidad. Incorporamos inteligencia artificial e ia para empresas mediante agentes IA a medida que automatizan tareas y mejoran la experiencia del usuario. También ayudamos con servicios inteligencia de negocio y power bi para transformar datos en insights accionables. Todo ello integrado con buenas prácticas de ciberseguridad y despliegues automatizados en servicios cloud aws y azure.

¿Qué sigue? Puedes empezar con este flujo básico y evolucionarlo hacia pipelines más avanzados con pruebas automatizadas, análisis estático, despliegues canary y métricas de performance. Q2BSTUDIO ofrece auditorías, integración de agentes IA y proyectos de inteligencia artificial para empresas que buscan optimizar procesos, así como servicios gestionados para mantener tus entornos en producción.

Conclusión: con Ansible y GitHub Actions eliminas la fatiga de los despliegues manuales y ganas consistencia, velocidad y seguridad. Si quieres que Q2BSTUDIO implemente este flujo para tu proyecto, optimice la arquitectura en AWS o Azure, integre inteligencia artificial o mejore la seguridad de tus despliegues contacta con nosotros y te ayudamos a montar una solución a medida, segura y escalable que incluya aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA y power bi.

Publicado por Q2BSTUDIO empresa de desarrollo de software y soluciones tecnológicas

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.

Live Chat