Formations — 1 037 leçons en français

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 build ou npm 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.html pour toute URL ne correspondant à aucun fichier, afin que le routeur de l'application prenne la main. Sans elle, recharger /commandes/42 renvoie 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.

Lire l'explication détaillée et faire le quiz →

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.