Fai il deploy di Next.js su Nodion

Deploy di Next.js passo dopo passo

1. Tieni il lockfile e gli script standard Fai il commit di package-lock.json, yarn.lock, pnpm-lock.yaml o bun.lock; senza lockfile la build fallisce. next start ascolta sulla porta PORT impostata da Nodion, quindi gli script predefiniti funzionano così come sono. package.json

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

2. Crea l'app Nella dashboard crea un'applicazione dal tuo repository GitHub, GitLab, Bitbucket o Gitea, scegli il branch e la regione EU Central. Lascia la strategia di build su Buildpacks; se il repository contiene un Dockerfile, il modulo sceglie invece Dockerfile.
3. Imposta le variabili d'ambiente Tutto ciò che next build legge, come NEXT_PUBLIC_*, ha bisogno del flag Build nella scheda Environment; tutte le altre variabili esistono solo a runtime. Segna le chiavi API come segrete.
4. Collega PostgreSQL ed esegui le migrazioni Crea un database nella stessa regione e collegalo nella scheda Environment; al deploy successivo l'app riceve DATABASE_URL. Una riga release: in un Procfile viene eseguita una volta per ogni build, prima che parta la nuova versione. Tieni lo strumento di migrazione in dependencies: le dipendenze di sviluppo vengono rimosse dopo la build. Procfile

   release: npm run migrate

5. Push e deploy Ogni push sul branch crea una nuova release. Il traffico passa alla nuova release appena risponde su / con uno stato 2xx o 3xx; se la fase di release fallisce, la versione in esecuzione resta online.

Da sapere

• Export staticoCon output: 'export' in next.config, Nodion serve out/ con un server web statico e un fallback su index.html. Non gira nessun server Node, quindi basta la dimensione minima.
• Percorso dell'health checkSe / risponde 401 o 404, indica nelle impostazioni dell'app un percorso di health check che restituisca 200, per esempio un route handler su /api/health.
• MonorepoPunta la base directory sull'app Next.js. La build vede solo quella directory, quindi il lockfile deve trovarsi lì.

Cosa gestisce Nodion per te

• Deploy senza downtime Fai push sul tuo branch e Nodion crea una nuova release. Il traffico passa alle nuove istanze solo quando superano l'health check; una release fallita lascia attiva quella in esecuzione. Le app con un volume locale invece si riavviano, perché il disco appartiene a una sola istanza.
• Database accanto all'app PostgreSQL, pgvector, MySQL, Valkey e ClickHouse gestiti, nella stessa regione. I database collegati arrivano come DATABASE_URL, REDIS_URL o CLICKHOUSE_URL.
• Anteprime per ogni pull request Attiva le anteprime: ogni pull request del tuo repository riceve un'app dedicata, con un proprio URL e database nuovi e vuoti, creata automaticamente o manualmente. Le pull request dai fork e quelle dei bot vengono ignorate.
• Worker, cron job e scalabilità Esegui i worker come processi aggiuntivi della stessa app, pianifica i job nella scheda Cron e scala ogni processo fino a 16 istanze.
• Fase di release Con i buildpack, la riga release: del Procfile viene eseguita a ogni nuova build. Le app con Dockerfile, così come i redeploy e i rollback a un'immagine precedente, usano un comando di release impostato sull'app stessa, che ha anche la precedenza sulla riga del Procfile. Nei siti statici, la fase di release gira in un'immagine che contiene solo i file generati dalla build.
• Log e metriche Nella dashboard trovi log di build, release e runtime, oltre alle metriche di CPU, memoria, disco e rete per ogni istanza.
• Domini e HTTPS Un hostname predefinito con HTTPS dal primo deploy; i tuoi domini ricevono i certificati in automatico.

Per approfondire

• Alternative a Vercel in Europa: 5 opzioni per Next.js Funzioni sull'edge o un server Node.js sempre attivo accanto al database: cinque alternative a Vercel per Next.js, a confronto per modello di runtime e sede.
• Ambienti di anteprima spiegati: un'app per ogni pull request Una copia in esecuzione della tua app per ogni pull request: a cosa servono gli ambienti di anteprima, dove diventano complicati e come li gestisce Nodion.

Next.js su Nodion: domande e risposte