Requisitos
- Node.js 18+ instalado en local
- Cuenta en Vertra Cloud
Estructura del proyecto
Configuración
next.config.js
Para desplegar en Vertra Cloud, configura el modostandalone para optimizar el tamaño del build:
package.json
vertracloud.config
Versiones disponibles
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 o TypeScript) y la memoria. En Ajustes avanzados, confirma el comando de build
npm run buildy el comando de inicionpx next start -p 80; ambos vienen rellenados en los proyectos de Next.js. - 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.
Notas
- Memoria recomendada: 512 MB o más (el proceso de build es intensivo)
- Variables de entorno: configúralas desde el panel antes del primer build
- Usa
output: 'standalone'para reducir el tamaño del build - Las API Routes de Next.js funcionan con normalidad en la plataforma
- La aplicación debe escuchar en el puerto 80
Problemas comunes
El build falla por falta de memoria
El build falla por falta de memoria
El entorno de build ya recibe automáticamente 2× la RAM de la aplicación. Si aun así falla,
sube la memoria de la propia aplicación a al menos 512 MB: el entorno de build escala con ella.
El build supera el límite de tiempo
El build supera el límite de tiempo
build_command tiene un límite de 10 minutos (BUILD_TIMEOUT). Reduce las dependencias o divide un build muy grande.La página devuelve 404
La página devuelve 404
Comprueba si
output: 'standalone' está configurado y si el build terminó correctamente según los logs.