Requisitos
- Node.js instalado en local (para desarrollo)
- Cuenta en Vertra Cloud
- Archivo
package.jsonen la raíz del proyecto
Estructura del proyecto
Configuración
package.json
Asegúrate de quepackage.json tenga definido un script start:
La plataforma ejecuta
npm install automáticamente antes de iniciar tu aplicación. No incluyas node_modules en la subida.vertracloud.config (opcional)
Ejemplo: servidor HTTP sencillo
Deploy
- Dashboard
- CLI
- VS Code
- Comprime el proyecto en un
.zip(las carpetas comonode_modules,venvytargetse eliminan automáticamente) o súbelo a GitHub. - En el panel, haz clic en Nuevo Proyecto y sube el
.zipo pega la URL del repositorio. - En Build, revisa el runtime (JavaScript), el archivo principal (
index.js) y la memoria. Los comandos de inicio y de build están en Ajustes avanzados. - Añade tus variables de entorno en Variables de Entorno.
- En Red, activa la publicación web para que la aplicación reciba una dirección
*.vertraweb.app(plan Pro o superior, 512 MB de memoria). La aplicación debe escuchar en el puerto 80. - Revisa y despliega. Sigue la salida en la pestaña Logs.
Versiones disponibles
Notas
- Las dependencias se instalan automáticamente con
npm install - Las variables de entorno se pueden configurar en el panel o mediante la API
- Los logs están disponibles en tiempo real en la terminal del panel
- El reinicio automático está activado por defecto y reinicia la aplicación automáticamente si falla
- Escucha siempre en
process.env.PORTy en el host0.0.0.0
Problemas comunes
Error: Cannot find module
Error: Cannot find module
Asegúrate de que todas las dependencias estén listadas en
package.json. La plataforma solo instala lo que está declarado.EADDRINUSE: address already in use
EADDRINUSE: address already in use
Es posible que tu aplicación intente usar un puerto fijo. Usa
process.env.PORT para el puerto correcto.El contenedor no deja de reiniciarse
El contenedor no deja de reiniciarse
Revisa los logs para identificar el error. Los errores de sintaxis o las dependencias que faltan son causas habituales. El sistema de detección de crash loop pausará el reinicio automático tras 5 caídas en 10 minutos.