CI/CD para Node.js en hosting compartido con cPanel y buenas prácticas de despliegue
En Q2BSTUDIO, empresa de desarrollo de software y aplicaciones a medida especializada en inteligencia artificial, ciberseguridad y servicios cloud, ayudamos a implementar pipelines CI/CD eficientes para ejecutar aplicaciones Node.js en entornos de hosting compartido con cPanel. Si necesitas desarrollar soluciones a medida o una aplicación multiplaforma visita nuestros servicios de desarrollo de aplicaciones y software a medida y si tu proyecto requiere integración con la nube revisa nuestros servicios cloud AWS y Azure.
Paso 1 Seguridad del hosting. Si tu subdominio muestra un listado de directorios o permite descargar archivos, añade un fichero .htaccess en la raíz de la aplicación para desactivar el listado y proteger archivos sensibles. Ejemplo de reglas recomendadas en .htaccess para bloquear el listado y proteger ficheros de entorno: <!-- .htaccess ejemplo --> Options -Indexes <FilesMatch ^(\.env|.*\.json|.*\.lock|.*\.md)$> Order allow,deny Deny from all </FilesMatch> Mantén siempre fuera del repositorio archivos de configuración y variables de entorno.
Paso 2 Configurar Node.js en cPanel. Accede a cPanel y busca Setup Node.js App. Crea una aplicación seleccionando la versión de Node recomendada por tu proveedor, por ejemplo 18, 20 o 22. Define el Application Root en la ruta del sitio, por ejemplo /home/usuario/mi-api.example.com y el archivo de inicio como index.js. Desde el panel puedes crear y arrancar la app y revisar logs básicos.
Paso 3 Preparar el proyecto para despliegue. Asegúrate de que .env no esté en Git y que npm install --production funciona correctamente. Estructura típica: auth_files, node_modules, uploads, whatsapp_instances, .env, index.js, package.json, package-lock.json. No incluyas node_modules en el control de versiones, deja que el despliegue instale dependencias.
Paso 4 Pipeline CI/CD con GitHub Actions. Crea .github/workflows/deploy.yml y define pasos claros: checkout del repositorio, setup node con la versión adecuada, npm install --production, build si procede, copiar archivos al servidor por SCP y reiniciar la app por SSH. El flujo general es: al hacer push a la rama main GitHub Actions instala dependencias, empaqueta y sube los archivos al hosting y ejecuta un comando remoto para reiniciar el proceso Node, por ejemplo touch tmp/restart.txt o un script que lance pm2 o el gestor que utilices.
Paso 5 Secrets en GitHub. Añade en la configuración del repositorio los secretos necesarios para la conexión SSH: SSH_HOST, SSH_USERNAME, SSH_PASSWORD y SSH_PORT. Utiliza claves SSH cuando sea posible en lugar de contraseñas para mayor seguridad.
Cómo funciona en la práctica. Cada push a la rama principal dispara el workflow que: 1) recupera el código, 2) instala dependencias en el runner, 3) sube solo los ficheros necesarios al hosting mediante scp o rsync, 4) ejecuta comandos remotos por SSH para instalar dependencias finales y reiniciar la aplicación. Este proceso permite despliegues rápidos, repetibles y automatizados.
Buenas prácticas y recomendaciones. Usa .htaccess para bloquear listados y proteger archivos sensibles. Nunca subas .env ni secretos al repositorio. Mantén la versión de Node alineada con la soportada por el hosting. Prefiere despliegues atómicos y pruebas en un entorno staging antes de producción. Considera integraciones adicionales como monitorización, backups y tests automatizados en el pipeline.
Servicios complementarios de Q2BSTUDIO. Podemos ayudarte a diseñar y ejecutar tu CI/CD y la seguridad del entorno, aplicar inteligencia artificial y agentes IA para automatizar procesos y mejorar la toma de decisiones, o implantar soluciones de inteligencia de negocio y power bi. Si tu proyecto requiere ciberseguridad o pentesting también ofrecemos servicios especializados para asegurar tus aplicaciones. Contacta con nosotros para una auditoría y despliegue profesional.
Palabras clave relevantes para posicionamiento: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi.
