Despliega Next.js en Nodion

Despliega Next.js paso a paso

1. Mantén un lockfile y los scripts habituales Haz commit de package-lock.json, yarn.lock, pnpm-lock.yaml o bun.lock; sin lockfile, la build falla. next start escucha en el PORT que define Nodion, así que los scripts por defecto funcionan tal cual. package.json

   "scripts": {
     "build": "next build",
     "start": "next start"
   }

2. Crea la app En el dashboard, crea una aplicación desde tu repositorio de GitHub, GitLab, Bitbucket o Gitea y elige la rama y la región EU Central. Deja la estrategia de build en Buildpacks; si el repositorio tiene un Dockerfile, el formulario elige Dockerfile en su lugar.
3. Define las variables de entorno Todo lo que lee next build, como NEXT_PUBLIC_*, necesita la opción Build en la pestaña Environment; el resto de variables solo existen en tiempo de ejecución. Marca las claves de API como secretas.
4. Vincula PostgreSQL y ejecuta las migraciones Crea una base de datos en la misma región y vincúlala en la pestaña Environment; la app recibe DATABASE_URL en el siguiente despliegue. Una línea release: en un Procfile se ejecuta una vez por build, antes de que arranque la nueva versión. Deja tu herramienta de migraciones en dependencies: las dependencias de desarrollo se eliminan después de la build. Procfile

   release: npm run migrate

5. Haz push para desplegar Cada push a la rama genera una nueva release. El tráfico pasa a ella en cuanto responde en / con un estado 2xx o 3xx; si falla el paso de release, la versión en ejecución sigue activa.

A tener en cuenta

• Exportación estáticaCon output: 'export' en next.config, Nodion sirve out/ con un servidor web estático y fallback a index.html. No se ejecuta ningún servidor Node, así que basta con el tamaño más pequeño.
• Ruta del health checkSi / responde 401 o 404, define en los ajustes de la app una ruta de health check que devuelva 200, por ejemplo un route handler en /api/health.
• MonoreposConfigura Base directory con la ruta de la app Next.js. La build solo ve ese directorio, así que el lockfile tiene que estar dentro.

Lo que Nodion gestiona por ti

• Despliegues sin downtime Haz push a tu rama y Nodion construye una nueva release. El tráfico pasa a las nuevas instancias cuando superan el health check; si una release falla, la que está en marcha sigue activa. En cambio, las apps con un volumen local se reinician porque el disco pertenece a una sola instancia.
• Bases de datos junto a la app PostgreSQL, pgvector, MySQL, Valkey y ClickHouse gestionados en la misma región. Al vincular una base de datos, sus datos de conexión llegan como DATABASE_URL, REDIS_URL o CLICKHOUSE_URL.
• Previews por pull request Activa las previews: cada pull request de tu repositorio tendrá su propia app, con URL y bases de datos nuevas y vacías. Puedes crearla automáticamente o a mano. Se omiten las pull requests de forks y bots.
• Workers, cron jobs y escalado Ejecuta workers como procesos adicionales de la misma app, programa tareas en la pestaña Cron y escala cada proceso hasta 16 instancias.
• Paso de release Con buildpacks, una línea release: del Procfile se ejecuta con cada nueva build. Las apps con Dockerfile, así como los redeploys o rollbacks a una imagen anterior, usan un comando de release definido en la propia app, que además tiene prioridad sobre la línea del Procfile. En los sitios estáticos, el paso de release se ejecuta en una imagen que solo contiene los archivos generados por la build.
• Logs y métricas Logs de build, release y runtime, además de métricas de CPU, memoria, disco y red de cada instancia, en el dashboard.
• Dominios y HTTPS Un nombre de host predeterminado con HTTPS desde el primer despliegue; tus propios dominios reciben certificados automáticamente.

Para seguir leyendo

• Alternativas a Vercel en Europa: 5 opciones para Next.js Funciones en el edge o un servidor Node.js siempre activo junto a tu base de datos: cinco alternativas a Vercel para Next.js, comparadas por modelo de runtime y ubicación.
• Entornos de preview: una app para cada pull request Una copia en ejecución de tu app para cada pull request: para qué sirven los entornos de preview, dónde se complican y cómo los gestiona Nodion.

Next.js en Nodion: preguntas y respuestas