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 read • Q2BSTUDIO Team

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

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat