CDN:Configure CDN cache expiration time

Fonctionnement

Lorsqu'une requête atteint un point de présence (POP) CDNDCDN, le système utilise le processus priorisé suivant pour décider s'il doit servir une copie mise en cache ou récupérer le dernier contenu depuis le serveur d'origine.

1. CDNDCDN ne met pas en cache les ressources si le serveur d'origine répond avec pragma:no-cache, cache-control:no-cache (ou no-store, ou max-age=0).

2. Les règles de cache configurées dans la console CDNDCDN sont prioritaires, sauf si le serveur d'origine envoie explicitement une directive no-cache comme décrit ci-dessus.

   • Logique de priorité lorsque plusieurs règles de cache de la console correspondent à une requête :

     Scénario	Logique de priorité	Exemple
     Poids différents	La règle ayant le poids le plus élevé (1-99) est prioritaire.	La règle A (répertoire /image/, poids 50) et la règle B (extension de fichier .jpg, poids 90) correspondent toutes deux à image/a.jpg. La règle B s'applique car elle a un poids plus élevé.
     Même poids	La règle créée en premier est prioritaire.	Vous configurez une règle de répertoire (/static/) et une règle d'extension de fichier (.js) pour un nom de domaine, toutes deux avec un poids de 60. Si la règle de répertoire a été créée avant la règle d'extension de fichier, une requête pour /static/app.js correspond à la règle de répertoire.

   • Dès qu'une requête correspond à une règle de cache, aucune autre règle n'est évaluée.

   • Par défaut, si le serveur d'origine répond avec Pragma: no-cache ou Cache-Control: no-cache/no-store/max-age=0, le POP CDNDCDN ne met pas la ressource en cache. Pour forcer la mise en cache, sélectionnez Ignore Origin No-Cache Header lors de la configuration de la règle d'expiration du cache.

3. CDNDCDN respecte les en-têtes de réponse HTTP du serveur d'origine si une requête ne correspond à aucune règle de la console CDNDCDN, ou si la règle correspondante a l'option Honor Origin TTL activée. La priorité des en-têtes, de la plus élevée à la plus faible, est la suivante : cache-control > expires > last-modified > ETag.

   En-tête de réponse	CDN gestion	Remarques et exemples
   Cache-Control	Utilise d'abord s-maxage (durée du cache CDN), puis max-age.	Exemple : s-maxage=86400, max-age=3600
   Expires	Spécifie l'heure d'expiration. Cet en-tête n'est utilisé que si aucun en-tête Cache-Control n'est présent.	Exemple : Expires: Wed, 21 Oct 2025 07:28:00 GMT
   Last-Modified	L'en-tête Last-Modified est un horodatage indiquant la dernière modification de la ressource. La durée du cache est calculée comme suit : (Heure actuelle - last-modified) × 0,1. La durée calculée est ensuite plafonnée entre un minimum de 10 secondes et un maximum de 3 600 secondes.	Exemple : Last-Modified: Wed, 21 Oct 2023 07:28:00 GMT
   ETag	Un ETag est un identifiant unique généré par le serveur pour une version spécifique d'une ressource, généralement un hachage ou un numéro de version. Par défaut, une ressource avec un ETag est mise en cache pendant 10 secondes.	Exemple : ETag: "abc123"

4. Politique no-cache CDNDCDN : Si une requête ne correspond à aucune règle de cache dans la console CDNDCDN et que le serveur d'origine ne renvoie pas d'en-têtes de réponse de cache tels que Cache-Control, alors CDNDCDN applique une politique no-cache.

Procédure

Appliquer immédiatement les modifications de règle

Les nouvelles règles ou les règles modifiées s'appliquent uniquement aux ressources nouvellement mises en cache. Les ressources précédemment mises en cache continuent d'utiliser l'ancienne politique de cache jusqu'à leur expiration.

Pour appliquer immédiatement les nouvelles règles à l'ensemble du réseau, vous devez vider manuellement le cache existant. Si vous modifiez une règle, effectuez une opération de purge en utilisant la fonctionnalité Purge and Prefetch resources. Si vous ajoutez une nouvelle règle, effectuez une opération de préchargement en utilisant la fonctionnalité prefetch resource.

Vérification

Une fois la configuration terminée, vous pouvez utiliser la commande curl ou les outils de développement du navigateur pour inspecter les en-têtes de réponse HTTP d'une ressource afin de vérifier que la mise en cache fonctionne comme prévu.

curl -I "https://your.domain.com/path/to/file.jpg"

Meilleures pratiques

• Utilisez des noms de fichiers versionnés (recommandé) : lorsque vous mettez à jour une ressource statique comme style.css, utilisez un nouveau nom de fichier avec une version ou un hachage, tel que style-v2.css ou style-a1b2c3d.css, et mettez à jour la référence dans votre HTML. Cette méthode garantit que les utilisateurs reçoivent immédiatement le dernier contenu sans nécessiter de purge manuelle du cache CDNDCDN et constitue la méthode recommandée pour mettre à jour le contenu mis en cache.

• Mettez en œuvre la séparation du contenu dynamique et statique : utilisez des noms de domaine ou des chemins de répertoire différents pour les ressources dynamiques et statiques. Configurez des règles de cache distinctes à poids élevé pour chacune afin d'éviter les conflits de politique. Par exemple, définissez une longue durée de cache pour toutes les ressources dans le répertoire /static/ et aucun cache pour les ressources dans le répertoire /api/.

• Utilisez efficacement le cache du navigateur : activez « Client follows CDNDCDN cache policy » pour réduire les requêtes répétées vers CDNDCDN, améliorer la vitesse de chargement et économiser le trafic CDNDCDN.

• Évitez les durées de cache excessivement courtes : une durée de cache courte amène CDNDCDN à effectuer des récupérations fréquentes depuis l'origine, ce qui annule les avantages de l'accélération et augmente le trafic et les coûts de votre serveur d'origine.

• Soyez prudent avec les longues durées de cache : une longue durée de cache peut empêcher les clients de recevoir rapidement les mises à jour de contenu. Pour le contenu nécessitant des mises à jour fréquentes, assurez-vous de purger le cache ou d'utiliser des noms de fichiers versionnés.

• Scénarios de petits fichiers : pour les ressources de petits fichiers dans l'industrie du jeu (telles que les fichiers de configuration et les packages d'actifs) qui sont mises à jour peu fréquemment (par exemple, hebdomadairement ou bimensuellement), définissez la durée d'expiration du cache sur 15 jours ou adaptez-la au cycle réel de mise à jour des ressources. Cela équilibre la vitesse de mise à jour et les performances d'accélération. Une durée de cache trop courte entraîne des récupérations fréquentes depuis l'origine et réduit les avantages de l'accélération ; une durée trop longue peut servir du contenu obsolète aux joueurs. Nous vous recommandons d'utiliser la fonctionnalité purge and prefetch pour actualiser proactivement le cache lorsque le contenu est mis à jour.

• robots.txt et sitemap.xml : ces fichiers affectent directement l'exploration par les moteurs de recherche. Configurez leur durée de cache séparément pour éviter qu'ils ne soient mis en correspondance par une règle d'extension large qui les mettrait en cache trop longtemps, ce qui retarderait les mises à jour. Pour cibler uniquement ces deux fichiers, sélectionnez Directory comme type et saisissez le chemin de fichier spécifique (tel que /robots.txt) comme adresse, puis définissez un poids élevé pour remplacer les règles d'extension larges. Si vous préférez configurer par extension de fichier, définissez une durée de cache de 1 heure à 1 jour pour les extensions txt,xml. Pour les sitemaps fréquemment mis à jour, définissez la durée de cache sur pas plus d'1 heure.

• Le type d'activité ne prédéfinit pas les politiques de cache : le type d'activité que vous sélectionnez lors de la création d'un nom de domaine accéléré (tel que Image and Small File, Large File Download ou On-demand Video/Audio Streaming) ne prédéfinit pas de durées de cache fixes pour des extensions de fichier ou des chemins spécifiques. Le comportement de mise en cache réel est déterminé par les règles de cache que vous configurez dans la console. Après avoir créé le nom de domaine, configurez les règles de cache en fonction de vos types de ressources et de leur fréquence de mise à jour.

Mécanismes de contrôle du cache HTTP

FAQ

Pour savoir comment résoudre les problèmes liés à la mise en cache qui ne prend pas effet, aux échecs du cache, à un faible taux de succès du cache et au contenu qui n'est pas mis à jour, reportez-vous à Cache troubleshooting.