Formations — 1 037 leçons en français

Accueil › Déploiement & mise en production › Cache, versions et déploiements sans casse

Cache, versions et déploiements sans casse

Déployer un frontdebutant

Deux natures de fichiers, deux politiques opposées.

Fichier Nom Cache
main-A7F3C2.js change à chaque build un an, immutable
index.html ne change jamais no-cache
location ~* \.(js|css|woff2)$ {
    add_header Cache-Control "public, max-age=31536000, immutable";
}

location = /index.html {
    add_header Cache-Control "no-cache";
}

La logique tient en une phrase : ce dont le nom change peut être gardé pour toujours ; ce dont le nom ne change pas doit être revérifié à chaque fois.

index.html est le point d'entrée : c'est lui qui dit quels fichiers charger. Le mettre en cache gèle l'application sur l'ancienne version — et l'utilisateur ne voit aucun des correctifs déployés, parfois pendant des jours.

Attention au vocabulaire : no-cache ne veut pas dire « ne garde rien ». Il veut dire « demande-moi avant de réutiliser ». Le fichier est conservé, et le serveur répond 304 s'il n'a pas bougé : un aller-retour, pas un téléchargement.

Les termes à connaître

Empreinte de contenu (hashing)

Nom de fichier incluant une empreinte de son contenu (main-A7F3C2.js). Produit automatiquement par le build : un changement de contenu change le nom, donc l'URL.

Cache-Control

En-tête qui dicte combien de temps une réponse peut être réutilisée sans redemander. max-age=31536000, immutable pour un fichier à empreinte, no-cache pour index.html.

immutable

Directive qui promet au navigateur que le contenu de cette URL ne changera jamais. Il cesse alors même de revalider. À ne poser que sur des fichiers à empreinte.

no-cache

Ne signifie pas « ne pas mettre en cache » mais « revalider avant chaque réutilisation ». Le navigateur garde le fichier et demande au serveur s'il a changé — réponse 304 s'il n'a pas bougé.

Purge de cache

Invalidation forcée des copies détenues par un CDN. Nécessaire pour les fichiers sans empreinte ; inutile pour les autres, dont l'URL change à chaque version.

Erreur de chunk manquant

Panne classique d'une SPA : l'utilisateur a chargé l'ancienne page, un déploiement supprime les anciens fichiers, et la navigation suivante demande un morceau de code qui n'existe plus. Message typique : ChunkLoadError: Loading chunk 5 failed.

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.