Loading...

Apprendre / Déploiement

Comment déployer une application Next.js sur cdn.com.tr

Livrez une application Next.js en production sans gérer de serveurs : conteneurisez-la une fois, poussez vers Git, et cdn.com.tr la construit, l'exécute comme une container app managée et la diffuse depuis l'edge du CDN avec un domaine personnalisé et du HTTPS automatique.

8 min de lecture Intermédiaire Updated

Comment déployer une application Next.js sur cdn.com.tr

Ce dont vous avez besoin

Vous avez besoin de trois choses : une application Next.js (une existante convient), un dépôt Git pour elle (GitHub fonctionne d'emblée), et un compte cdn.com.tr. Vous n'aurez pas besoin de provisionner un serveur, d'installer Node sur une VM, ou de configurer un reverse proxy — la plateforme gère l'environnement d'exécution, le TLS et la diffusion. Le seul changement côté application est de demander à Next.js de produire un build autonome afin qu'il tourne proprement dans un conteneur.

Préparez l'application pour un conteneur

D'abord, activez la sortie standalone de Next.js. Cela n'inclut que les fichiers dont le serveur a besoin, ce qui garde l'image petite et le conteneur simple.

next.config.js

// next.config.js
module.exports = {
  output: 'standalone',
};

Ajoutez un Dockerfile

Un petit Dockerfile multi-étapes construit l'application dans une étape et ne livre que la sortie d'exécution dans la suivante. Ajoutez ce fichier à la racine de votre dépôt.

Dockerfile

# Étape de build
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# Étape d'exécution
FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
EXPOSE 3000
CMD ["node", "server.js"]

Déployer depuis Git (recommandé)

Dans le panneau cdn.com.tr, créez une container app et connectez votre dépôt Git. La plateforme lit votre Dockerfile, construit l'image et exécute le conteneur — aucun serveur de build à maintenir. Ensuite, déployer revient simplement à pousser vers votre branche : chaque push déclenche une nouvelle build et un déploiement sans interruption.

Livrer un changement

git add .
git commit -m "Update homepage"
git push origin main
# cdn.com.tr construit la nouvelle image et la déploie automatiquement
Comment déployer une application Next.js sur cdn.com.tr — Déployer depuis Git (recommandé)
Plateformes gérées et container apps sur cdn.com.tr.

Ou déployez avec la CLI cdnctl

Vous préférez la ligne de commande ou un pipeline CI ? La CLI opérateur cdnctl gère vos container apps comme du code. Connectez-vous une fois et choisissez votre compte, puis créez l'app à partir d'une image que vous avez poussée vers un registre — et utilisez le même outil pour suivre les logs, dimensionner ou revenir en arrière. C'est ce qui rend cdn.com.tr rapide à utiliser pour livrer : une commande au lieu d'un enchaînement de clics dans une console.

cdnctl
cdnctl login
cdnctl accounts use <account_uuid>

# créer l'app à partir de votre image poussée, sur votre domaine
cdnctl container apps create \
  --name my-nextjs \
  --image registry.example.com/acme/my-nextjs --tag 1.0.0 \
  --port 3000 --domain app.example.com \
  --healthcheck /api/health --healthcheck-type http

# ensuite, à tout moment :
cdnctl container apps logs   --app <app_uuid> --tail 100
cdnctl container apps scale  --app <app_uuid> --replicas 2
cdnctl container apps deploy --app <app_uuid>

Domaine personnalisé, HTTPS et l'edge

Pointez votre domaine vers l'app et cdn.com.tr délivre et renouvelle un certificat SSL automatiquement — aucun certbot manuel. Votre application Next.js tourne désormais derrière l'edge du CDN, si bien que les ressources statiques sont mises en cache et livrées près de chaque visiteur, un WAF filtre le trafic malveillant, et les pics de trafic sont absorbés en périphérie au lieu de marteler un seul conteneur. Vous obtenez un déploiement Next.js de production rapide et sécurisé sans exploiter aucune infrastructure en dessous.

Bien adapté pour

Sites marketing & de contenu

Les pages Next.js servies depuis l'edge se chargent vite dans le monde entier et restent en ligne pendant un lancement ou un moment viral.

Applications full-stack & APIs

Exécutez vos routes API Next.js et le SSR comme un conteneur managé avec du HTTPS automatique et un WAF devant.

Équipes qui livrent souvent

Les déploiements par push Git avec des rollouts sans interruption conviennent à la CI et aux releases fréquentes, sans avoir à surveiller de serveurs.

FAQ déploiement Next.js

Le SSR et les routes API fonctionnent-ils, ou seulement l'export statique ?

Les deux fonctionnent. Comme l'application tourne comme un vrai conteneur Node (pas un export statique), le rendu côté serveur, les routes API et les middlewares fonctionnent tous normalement. Le CDN met en cache ce qui est cachable et transmet les requêtes dynamiques au conteneur.

Comment fonctionnent les mises à jour et les retours en arrière ?

Chaque push vers votre branche connectée construit une nouvelle image et la déploie sans interruption. Si une build échoue, la version précédente continue à servir, si bien qu'un mauvais commit ne met pas votre site hors ligne.

Dois-je gérer le serveur, la version de Node ou le SSL ?

Non. L'environnement d'exécution du conteneur, le dimensionnement, les certificats TLS et l'edge sont gérés pour vous. Vous contrôlez l'application et son Dockerfile ; l'infrastructure sous-jacente est prise en charge.