Accueil › Déploiement & mise en production › Publier un front statique
Publier un front statique
Déployer un frontdebutant
Un front moderne se compile en fichiers statiques. Rien ne s'exécute côté serveur : il n'y a qu'un dossier à servir.
ng build # produit dist/boutique/browser/
npx wrangler pages deploy dist/boutique/browser
Trois choses à régler, et elles reviennent dans chaque entretien front.
1. Le repli sur index.html. L'application gère ses propres URL, mais le serveur ne les connaît pas. Sans règle de repli, recharger /commandes/42 donne une 404.
location / {
try_files $uri $uri/ /index.html;
}
Chez un hébergeur statique, c'est une case à cocher ou une ligne de configuration.
2. Le chemin de base. Si le site est servi depuis /app/, il faut le dire au build :
ng build --base-href /app/
Sinon l'application cherche ses fichiers à la racine du domaine, et tout revient en 404.
3. La compression. Un bundle Angular non compressé pèse souvent 800 Ko ; en Brotli, autour de 180 Ko. Les hébergeurs statiques le font d'office, un serveur maison non.
Les termes à connaître
- Build statique
Résultat de
ng buildounpm run build: un dossier de fichiers HTML, CSS, JavaScript et images. Aucun code ne s'exécute côté serveur — n'importe quel hébergeur de fichiers suffit.- Hébergeur statique
Service qui sert un dossier de fichiers depuis un réseau réparti (Cloudflare Pages, Netlify, Vercel, un seau S3 derrière CloudFront). Pas de serveur à administrer, pas de mise à jour système.
- Repli sur index.html (SPA fallback)
Règle qui renvoie
index.htmlpour toute URL ne correspondant à aucun fichier, afin que le routeur de l'application prenne la main. Sans elle, recharger/commandes/42renvoie une 404.- Base href
Balise
<base href="/">qui dit à l'application à partir de quelle racine construire ses URL. À ajuster si le site est servi depuis un sous-chemin (/app/).- Routage par hash
Mode de routage où le chemin suit un
#(/#/commandes/42). Le serveur ne reçoit jamais la partie qui suit : aucune règle de repli n'est nécessaire, mais rien de ce qui suit le#n'est indexable.- Compression
Réduction de la taille des réponses (gzip, Brotli) avant envoi. Divise typiquement par trois à cinq le poids d'un bundle JavaScript. Activée par défaut chez les hébergeurs statiques, à configurer explicitement sur un serveur maison.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.