Documentation

Guide de déploiement

Un guide pratique pour publier des sites statiques, préparer des dossiers de build, connecter des domaines et mettre à jour des projets sur DeployPages.

Déploiement ReactExport Next.jsRecherche DNSVérification SSLGénérateur meta

Démarrage rapide

Déployer signifie transformer des fichiers de site locaux en URL que les gens peuvent ouvrir. DeployPages est conçu pour les sorties statiques, donc la première publication peut commencer par un dossier plutôt que par une configuration serveur.

Option 1 : déploiement glisser-déposer

Le chemin le plus rapide pour les projets statiques. Si le site est déjà en HTML, CSS, JavaScript ou dans un dossier de build terminé, vous pouvez le téléverser directement.

Bon pour

Landing pages, sites personnels, CV, prototypes, documentation statique et autres sorties front-end que le navigateur peut ouvrir seul.
  • 1
    Préparer le dossier du projet

    Votre dossier déployable doit inclure un fichier index.html à la racine ainsi que les styles, scripts ou images dont la page dépend.

    Exemple de structure de dossier
    my-site/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    Erreur fréquente

    Si index.html manque ou se trouve dans un sous-dossier, le site ne s'ouvrira pas correctement après téléversement.
  • 2
    Ouvrir la zone de téléversement

    Utilisez la zone de téléversement sur DeployPages. Vous pouvez publier d'abord un projet temporaire, puis vous connecter plus tard si vous voulez le garder.

  • 3
    Téléverser le dossier

    Glissez tout le dossier dans la zone de téléversement ou choisissez-le depuis le sélecteur de fichiers. Pour les frameworks, téléversez le dossier de build plutôt que l'arborescence source.

  • 4
    Ouvrir l'URL générée

    Quand le téléversement se termine, DeployPages renvoie une URL en ligne que vous pouvez utiliser immédiatement pour tester ou partager.

Option 2 : flux CLI

Utile quand le même build sort régulièrement et que le déploiement doit vivre dans un script, un job CI ou une checklist de publication.

À utiliser quand le projet devient répétable

Le glisser-déposer reste meilleur pour les prévisualisations ponctuelles. Un flux CLI a du sens quand une équipe doit publier le même dossier de sortie de la même manière à chaque fois.

Installer la CLI

Utilisez le gestionnaire de paquets de votre choix pour installer la CLI globalement.

npm install -g @deploypages/cli

S'authentifier

Lancez la commande de login et terminez l'étape d'autorisation dans le navigateur.

deploypages login

Déployer le dossier courant

Lancez la commande deploy depuis le dossier de sortie du build.

deploypages deploy

Préparer les builds par framework

Les frameworks modernes demandent une étape de build avant téléversement. L'objectif est toujours le même : générer des fichiers statiques que le navigateur peut ouvrir directement.

Ce que signifie “build”

Un build convertit les fichiers source du framework en HTML, CSS, JavaScript et fichiers déployables.

React / Vue / Vite

Command:npm run build
Output:dist/

Téléversez le dossier dist lui-même, pas la racine du projet.

Export statique Next.js

Command:npm run build
Output:out/

Définissez output: 'export' dans next.config.js avant de générer le build.

HTML simple

Command:Aucune étape de build requise
Output:Votre dossier existant

Gardez simplement index.html à la racine.

Hugo / Hexo

Command:hugo ou hexo generate
Output:public/

Téléversez le dossier public généré.

Exemple d'export Next.js

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

Limites de l'export statique

Les fonctionnalités rendues serveur comme API routes, server-side props et middleware ne sont pas disponibles dans un build d'export statique.

Domaines personnalisés

DeployPages peut rattacher votre propre nom de domaine après le premier déploiement afin que le projet passe d'une URL système à une adresse de production de marque.

Qu'est-ce qui compte comme domaine ?

Tout domaine que vous gérez chez un bureau d'enregistrement peut fonctionner, tant que vous pouvez modifier ses enregistrements DNS.

Étape 1 : ajouter le domaine dans la console

Allez dans les paramètres du projet, ouvrez l'onglet domaines et ajoutez le nom d'hôte à connecter.

Étape 2 : configurer le DNS

DeployPages fournira les cibles DNS nécessaires pour la vérification de propriété et le routage du trafic.

Étape 3 : attendre la vérification

Quand le DNS s'est propagé, l'état du domaine devient valide et le provisionnement HTTPS peut se terminer.

TypeHôteValeurObjectif
CNAMEwwwcname.deploypages.sitePointer le trafic vers la plateforme
TXT_deploypages-challengedeploypages-verify=...Vérifier la propriété du domaine

Choisir l'hôte DNS

  • Utilisez www pour connecter www.example.com.
  • Utilisez @ pour connecter le domaine racine example.com.
  • Utilisez un libellé de sous-domaine comme blog pour connecter blog.example.com.

Mettre à jour un site

Même parcours, nouvelle version

Mettre à jour un projet suit la même logique que le premier déploiement : générer la dernière sortie, la téléverser et laisser la plateforme remplacer la version en ligne.
  • 1
    Modifier les fichiers source

    Changez textes, styles, médias ou fichiers localement.

  • 2
    Reconstruire si nécessaire

    Si le projet utilise un framework, générez d'abord un nouveau dossier de sortie.

  • 3
    Ouvrir la console projet

    Retournez sur la page projet dans DeployPages.

  • 4
    Téléverser la nouvelle version

    Remplacez l'ancien build par le dernier dossier. L'historique de déploiement garde la nouvelle version traçable.

Une fois le téléversement terminé, le nouveau build passe en ligne et les versions précédentes restent disponibles pour retour arrière.

Questions fréquentes

Les non-développeurs peuvent-ils utiliser DeployPages ?
Oui. Si le site est déjà exporté en fichiers statiques, le déploiement glisser-déposer suffit.
Pourquoi vois-je un 404 après déploiement ?
La raison la plus courante est un fichier index.html manquant ou mal placé. Vérifiez que le fichier d'entrée déployable est à la racine du dossier téléversé.
Et si les routes React ou Vue cassent au rafraîchissement ?
DeployPages prend en charge le repli SPA pour les configurations front-end statiques courantes, mais le build doit quand même être exporté correctement.
Puis-je téléverser des vidéos ou fichiers plus lourds ?
Oui, mais la performance est meilleure quand les très gros médias sont optimisés ou hébergés via un service adapté.
Puis-je protéger un site par mot de passe ?
Oui sur les offres qui incluent la protection par mot de passe. Utilisez-la pour les prévisualisations, docs internes ou lancements en préproduction.
Aller à Explore