Saltar al contenido principal

Requisitos

  • Node.js instalado en local (para desarrollo)
  • Cuenta en Vertra Cloud
  • Archivo package.json en la raíz del proyecto

Estructura del proyecto

Configuración

package.json

Asegúrate de que package.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

  1. Comprime el proyecto en un .zip (las carpetas como node_modules, venv y target se eliminan automáticamente) o súbelo a GitHub.
  2. En el panel, haz clic en Nuevo Proyecto y sube el .zip o pega la URL del repositorio.
  3. 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.
  4. Añade tus variables de entorno en Variables de Entorno.
  5. 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.
  6. Revisa y despliega. Sigue la salida en la pestaña Logs.
La guía completa está en Primer despliegue.

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.PORT y en el host 0.0.0.0

Problemas comunes

Asegúrate de que todas las dependencias estén listadas en package.json. La plataforma solo instala lo que está declarado.
Es posible que tu aplicación intente usar un puerto fijo. Usa process.env.PORT para el puerto correcto.
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.
Última modificación el 26 de octubre de 2026