Déployer un site statique sur Cloudflare Pages gratuitement : guide étape par étape
Déployer un site statique sur Cloudflare Pages gratuitement
Cloudflare Pages propose un hébergement statique gratuit ainsi qu’un CDN global, et s’intègre profondément à GitHub : push pour déployer. Voici le processus complet.
Prérequis
- Un dépôt GitHub (le code source de votre site)
- Un compte Cloudflare (le niveau gratuit suffit)
- Une commande de build et un répertoire de sortie (ex. Astro :
npm run build→dist)
Étapes de déploiement
1. Poussez le code vers GitHub
git init
git add -A
git commit -m "init"
git remote add origin https://github.com/crazynotesman-svg/markdown-pdf-studio.git
git push -u origin main
2. Connectez le dépôt dans Cloudflare Pages
- Tableau de bord Cloudflare → Workers & Pages → Create → Pages.
- Choisissez Connect to Git, autorisez et sélectionnez votre dépôt.
- Définissez le build :
- Build command :
npm run build - Build output directory :
dist
- Build command :
- Cliquez sur Save and Deploy.
3. Déploiement automatique à chaque mise à jour
Ensuite, tout git push fait en sorte que Cloudflare récupère, compile et publie automatiquement, et conserve un lien d’aperçu pour chaque déploiement.
Configurer un domaine personnalisé (facultatif)
Dans Custom domains du projet Pages, ajoutez votre domaine et pointez son CNAME DNS vers Pages comme indiqué. Cloudflare délivre un certificat SSL automatiquement, donc le HTTPS fonctionne d’emblée.
Pièges courants
- Liens absolus incorrects : n’oubliez pas de régler
sitedans votre configuration sur votre domaine réel, sinon le sitemap/canonical utilisera des adresses fictives. - Expiration du build : le niveau gratuit suffit pour les petits sites ; allégez les dépendances si vous en avez trop.
- Variables d’environnement : les sites purement statiques n’en ont généralement pas besoin, mais si besoin, configurez-les dans Settings → Environment variables de Pages.
En résumé
GitHub gère le contenu ; Cloudflare Pages gère la livraison — cette combinaison est à coût zéro, accélérée globalement et à déploiement automatique, idéale pour les projets personnels et les blogs techniques.
Le déploiement décrit ici est exactement la façon dont ce site est passé en production.