Deploy Next.js op Nodion

Next.js stap voor stap deployen

1. Gebruik een lockfile en de gebruikelijke scripts Commit package-lock.json, yarn.lock, pnpm-lock.yaml of bun.lock; zonder lockfile mislukt de build. next start luistert op de PORT die Nodion instelt, dus de standaardscripts werken zoals ze zijn. package.json

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

2. Maak de app aan Maak in het dashboard een applicatie aan vanuit je GitHub-, GitLab-, Bitbucket- of Gitea-repository en kies de branch en de regio EU Central. Laat de buildstrategie op Buildpacks staan; staat er een Dockerfile in de repository, dan kiest het formulier in plaats daarvan Dockerfile.
3. Stel omgevingsvariabelen in Alles wat next build leest, zoals NEXT_PUBLIC_*, heeft de vlag Build op het tabblad Environment nodig; alle andere variabelen bestaan alleen tijdens runtime. Markeer API-sleutels als secret.
4. Koppel PostgreSQL en voer migraties uit Maak een database aan in dezelfde regio en koppel die op het tabblad Environment; bij de volgende deployment krijgt de app DATABASE_URL. Een release:-regel in een Procfile draait één keer per build, voordat de nieuwe versie start. Zet je migratietool in dependencies: dev-dependencies worden na de build verwijderd. Procfile

   release: npm run migrate

5. Push om te deployen Elke push naar de branch bouwt een nieuwe release. Het verkeer gaat ernaar over zodra die op / antwoordt met een 2xx- of 3xx-status; mislukt de releasestap, dan blijft de draaiende versie live.

Goed om te weten

• Statische exportMet output: 'export' in next.config serveert Nodion out/ met een statische webserver en een fallback naar index.html. Er draait geen Node-server, dus de kleinste grootte is genoeg.
• Pad voor de health checkAntwoordt / met 401 of 404, stel dan in de app-instellingen een pad voor de health check in dat 200 teruggeeft, bijvoorbeeld een route handler op /api/health.
• Monorepo'sLaat de Base directory naar de Next.js-app wijzen. De build ziet alleen die map, dus de lockfile moet daarin staan.

Wat Nodion voor je regelt

• Deploys zonder downtime Push naar je branch en Nodion bouwt een nieuwe release. Het verkeer schakelt over zodra de nieuwe instanties hun health check doorstaan; een mislukte release laat de draaiende versie staan. Apps met een lokaal volume herstarten in plaats daarvan, omdat de schijf bij één instantie hoort.
• Databases naast de app Managed PostgreSQL, pgvector, MySQL, Valkey en ClickHouse in dezelfde regio. Gekoppelde databases komen binnen als DATABASE_URL, REDIS_URL of CLICKHOUSE_URL.
• Previews per pull request Zet previews aan en pull requests uit je repository krijgen een eigen app met een eigen URL en nieuwe, lege databases, automatisch of handmatig aangemaakt. Forks en pull requests van bots worden overgeslagen.
• Workers, cronjobs en schalen Draai workers als extra processen van dezelfde app, plan jobs op het tabblad Cron en schaal elk proces naar maximaal 16 instanties.
• Releasestap Met buildpacks draait een release:-regel in het Procfile bij elke nieuwe build. Dockerfile-apps, en redeploys of rollbacks naar een eerdere image, gebruiken een releasecommando dat op de app zelf is ingesteld en dat ook voorrang heeft op de Procfile-regel. Bij statische sites draait een releasestap in een image die alleen de gebouwde bestanden bevat.
• Logs en metrics Build-, release- en runtimelogs plus metrics voor CPU, geheugen, schijf en netwerk van elke instantie in het dashboard.
• Domeinen en HTTPS Een standaardhostnaam met HTTPS vanaf de eerste deploy; je eigen domeinen krijgen automatisch certificaten.

Verder lezen

• Alternatieven voor Vercel in Europa: 5 opties voor Next.js Functions aan de edge of een altijd draaiende Node.js-server naast je database: vijf alternatieven voor Vercel voor Next.js, vergeleken op runtimemodel en locatie.
• Previewomgevingen uitgelegd: een app per pull request Een draaiende kopie van je app voor elke pull request: waar previewomgevingen goed voor zijn, waar het lastig wordt en hoe Nodion ze afhandelt.

Next.js op Nodion: vragen en antwoorden