Déployez Next.js sur Nodion

Déployez Next.js étape par étape

1. Gardez un lockfile et les scripts habituels Commitez package-lock.json, yarn.lock, pnpm-lock.yaml ou bun.lock ; sans lockfile, le build échoue. next start écoute sur le PORT défini par Nodion, les scripts par défaut fonctionnent donc tels quels. package.json

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

2. Créez l'app Dans le dashboard, créez une application depuis votre dépôt GitHub, GitLab, Bitbucket ou Gitea, puis choisissez la branche et la région EU Central. Laissez la stratégie de build sur Buildpacks ; si le dépôt contient un Dockerfile, le formulaire choisit Dockerfile à la place.
3. Définissez les variables d'environnement Tout ce que lit next build, comme NEXT_PUBLIC_*, doit avoir l'option Build cochée dans l'onglet Environment ; toutes les autres variables n'existent qu'à l'exécution. Marquez les clés d'API comme secrètes.
4. Rattachez PostgreSQL et lancez les migrations Créez une base de données dans la même région et rattachez-la dans l'onglet Environment ; l'app reçoit DATABASE_URL au prochain déploiement. Une ligne release: dans un Procfile s'exécute une fois par build, avant le démarrage de la nouvelle version. Gardez votre outil de migration dans dependencies : les dépendances de développement sont supprimées après le build. Procfile

   release: npm run migrate

5. Poussez pour déployer Chaque push sur la branche construit une nouvelle release. Le trafic bascule vers elle dès qu'elle répond sur / avec un statut 2xx ou 3xx ; si l'étape de release échoue, la version en cours reste en ligne.

Bon à savoir

• Export statiqueAvec output: 'export' dans next.config, Nodion sert out/ avec un serveur web statique et un fallback vers index.html. Aucun serveur Node ne tourne, la plus petite taille suffit donc.
• Chemin du health checkSi / répond 401 ou 404, définissez dans les paramètres de l'app un chemin de health check qui renvoie 200, par exemple un route handler sur /api/health.
• MonoreposIndiquez le dossier de l'app Next.js comme Base directory. Le build ne voit que ce répertoire, le lockfile doit donc s'y trouver.

Ce que Nodion gère pour vous

• Déploiements sans interruption Faites un push sur votre branche : Nodion construit une nouvelle release. Le trafic bascule lorsque les nouvelles instances réussissent leur health check ; si la release échoue, celle en cours reste active. Les apps avec un volume local redémarrent, car le disque appartient à une seule instance.
• Bases de données à côté de l'app PostgreSQL, pgvector, MySQL, Valkey et ClickHouse managés, dans la même région. Les bases de données rattachées arrivent sous forme de DATABASE_URL, REDIS_URL ou CLICKHOUSE_URL.
• Previews par pull request Activez les previews, et les pull requests de votre dépôt obtiennent leur propre app, avec sa propre URL et des bases de données neuves et vides, créées automatiquement ou à la main. Les pull requests issues de forks ou de bots sont ignorées.
• Workers, cron jobs et mise à l'échelle Exécutez les workers comme processus supplémentaires de la même app, planifiez des tâches dans l'onglet Cron et mettez chaque processus à l'échelle jusqu'à 16 instances.
• Étape de release Avec les buildpacks, une ligne release: du Procfile s'exécute à chaque nouveau build. Les apps Dockerfile, ainsi que les redéploiements ou les rollbacks vers une image antérieure, utilisent une commande de release définie sur l'app elle-même, qui prime aussi sur la ligne du Procfile. Sur les sites statiques, l'étape de release s'exécute dans une image qui ne contient que les fichiers générés par le build.
• Logs et métriques Logs de build, de release et d'exécution, ainsi que les métriques CPU, mémoire, disque et réseau de chaque instance, dans le dashboard.
• Domaines et HTTPS Un nom d'hôte par défaut avec HTTPS dès le premier déploiement, et des certificats automatiques pour vos propres domaines.

Pour aller plus loin

• Alternatives à Vercel en Europe : 5 options pour Next.js Des fonctions à l'edge ou un serveur Node.js toujours actif à côté de votre base de données : cinq alternatives à Vercel pour Next.js, comparées par modèle d'exécution et localisation.
• Environnements de preview : une app par pull request Une copie de votre app en fonctionnement pour chaque pull request : à quoi servent les environnements de preview, où ils se compliquent et comment Nodion les gère.

Next.js sur Nodion : questions et réponses