Documentation · Cadriciels

Déployer Next.js.

Poussez un dépôt Next.js ou déposez le dossier — Canner le détecte, exécute next build et le sert comme un vrai processus Node. Rendu côté serveur, routes API, middleware et optimisation d’images fonctionnent sans configuration.

Zéro configuration, à dessein

La détection s’appuie sur la dépendance next de votre package.json. Canner exécute votre installation et votre script build, puis démarre l’application avec next start sur le port qu’il assigne. Aucune couche de traduction « serverless » : votre application est un processus Node de longue durée — websockets, réponses en continu et état en mémoire se comportent exactement comme next start sur votre machine.

Committez votre fichier de verrouillage. Les déploiements Node exigent package-lock.json (ou l’équivalent pnpm/yarn/bun) pour des builds reproductibles. S’il est désynchronisé, exécutez npm install localement et committez le résultat.

Ce qui persiste entre les builds

.next/cache survit d’un déploiement à l’autre : la compilation incrémentale et le cache d’optimisation d’images persistent — les builds suivants sont bien plus rapides que le premier. Les dépendances sont aussi mises en cache par fichier de verrouillage.

Variables d’environnement

Les variables définies sous l’onglet Variables d’environnement sont présentes au build et à l’exécution. N’oubliez pas la règle de Next.js : tout ce dont le navigateur a besoin doit être préfixé NEXT_PUBLIC_ et est intégré au moment du build — modifiez-la, puis redéployez.

Bon à savoir

  • L’ISR et revalidate fonctionnent — le cache vit sur le disque local avec le processus.
  • Pour les sites pilotés par un CMS, la mise en cache par étiquette peut servir les pages depuis le cache de Canner entre les publications.
  • output: "standalone" est accepté mais inutile; le build par défaut est ce que next start attend.
  • Monodépôt? Définissez le répertoire racine du projet vers le dossier de l’application dans les paramètres.