Despliega Nuxt en Nodion

Despliega Nuxt paso a paso

1. Mantén los scripts por defecto y un lockfile Haz commit de tu lockfile; sin él, la build falla. Los proyectos Nuxt no traen script start, y no lo necesitas: Nodion ejecuta tu script build y luego arranca .output/server/index.mjs, que escucha en el PORT que define Nodion. Si añades un script start, Nodion ejecuta ese en su lugar. package.json

   "scripts": {
     "build": "nuxt build",
     "dev": "nuxt dev"
   }

2. Crea la app En el dashboard, crea una aplicación desde tu repositorio de GitHub, GitLab, Bitbucket o Gitea, elige la rama y la región EU Central y deja la estrategia de build en Buildpacks.
3. Configura con variables NUXT_ Declara tus ajustes en runtimeConfig y defínelos como NUXT_API_SECRET o NUXT_PUBLIC_API_BASE en la pestaña Environment. Nuxt los lee al arrancar el servidor, así que no necesitan la opción Build. Solo la necesitan los valores que nuxt.config lee de process.env durante la build. nuxt.config.ts

   export default defineNuxtConfig({
     runtimeConfig: {
       apiSecret: "",
       public: {
         apiBase: "",
       },
     },
   });

4. Haz push para desplegar Cada push a la rama genera una nueva release. El tráfico pasa a ella en cuanto / responde con un estado 2xx o 3xx. Si / responde 401 o 404, añade una ruta de servidor como server/routes/health.ts y define /health como ruta de health check en los ajustes de la app.

A tener en cuenta

• Sitio estático con nuxt generateNodion no detecta nuxt generate por sí solo y sigue arrancando el servidor. Para un sitio estático, usa nuxt generate como script build y añade un static.toml con output-dir = ".output/public". Así Nodion sirve esa carpeta con un servidor web estático y fallback a index.html, y basta con el tamaño más pequeño.
• Preset de NitroNodion arranca .output/server/index.mjs, que genera el preset por defecto de Nitro, node-server. Si nuxt.config o NITRO_PRESET eligen un preset para otro proveedor de hosting, quítalo.

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

• 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.
• Cloud Native Buildpacks: qué son y cómo funcionan Los buildpacks convierten tu código fuente en una imagen de contenedor sin Dockerfile. Te explicamos qué son y cómo funcionan.

Nuxt en Nodion: preguntas y respuestas