CDN
Vider le cache de Kapsule CDN
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
Vider le cache efface la copie de votre contenu stockée à la périphérie pour que le prochain visiteur reçoive une version fraîchement récupérée depuis votre origine, ce que vous faites lorsque vous avez publié une modification et que l'ancienne version s'affiche toujours.
La mise en cache est ce qui rend le CDN rapide, et c'est aussi la raison pour laquelle une modification que vous venez de faire peut ne pas apparaître immédiatement. Au lieu de réduire vos durées de vie du cache à zéro, conservez-les longues et videz le cache à la demande. Ce guide couvre les deux aspects, plus comment distinguer un cache de périphérie d'un cache de navigateur avant de chercher au mauvais endroit.
Quand vous devez vider le cache
Videz le cache après avoir modifié quelque chose que les visiteurs récupèrent par URL :
- Vous avez remplacé un fichier CSS ou JavaScript et l'ancien est toujours servi.
- Vous avez téléchargé une nouvelle version d'une image sur un nom de fichier existant.
- Vous avez corrigé un bug sur une page et voulez que la version cassée disparaisse mondialement, maintenant.
- Vous avez modifié le contenu d'une page et ne pouvez pas attendre l'expiration du TTL de périphérie.
Vous n'avez pas besoin de vider le cache lorsque vous avez ajouté une page entièrement nouvelle ou un nouveau nom de fichier. Rien n'est mis en cache pour une URL qui n'a jamais été demandée.
Si vous versionnez vos noms de fichiers d'actifs (style.a1b2c3.css plutôt que style.css), vous avez rarement besoin de vider le cache du tout. Un nouveau nom de fichier est une nouvelle URL, donc elle est récupérée fraîchement depuis votre origine et mise en cache sous sa propre clé.
Où se trouve le contrôle de vidage du cache
- Connectez-vous à KPanel.
- Cliquez sur Websites dans la barre latérale gauche, puis cliquez sur votre site.
- Dans le menu du site, ouvrez Performance, puis Kapsule CDN.
- Faites défiler jusqu'à la carte Purge cache.
L'adresse directe est /websites/<site-id>/cdn.
Le contrôle de vidage du cache n'apparaît qu'une fois que le CDN est activé pour le site. Si la page affiche la bannière CDN is off for this site, ou vous demande de connecter un domaine personnalisé, il n'y a rien à la périphérie à vider pour le moment. Kapsule CDN est aussi un droit du plan, donc un site sur un plan Orbit ou Container Hosting n'a pas de CDN du tout. Enabling Kapsule CDN on Your Site liste exactement les plans qui l'incluent.
Vider le cache d'une seule URL
- Dans la carte Purge cache, tapez l'URL publique complète dans URL to purge (leave blank for whole site). L'espace réservé du champ montre la forme attendue :
https://your-domain.tld/path. - Cliquez sur Purge.
- Une confirmation apparaît indiquant « Purged » suivi de l'URL que vous avez entrée.
Utilisez l'URL exacte qu'un visiteur demanderait, en incluant le schéma (https://), l'hôte et le chemin. Un vidage du cache correspond à l'URL, donc https://example.com/about et https://example.com/about/ sont deux entrées de cache différentes, tout comme la même page avec une chaîne de requête attachée.
Vider le cache d'une seule URL est le bon premier mouvement quand vous savez exactement ce qui a changé. C'est instantané et cela laisse le reste de votre cache intact, donc le reste du site reste rapide.
Vider le cache du site entier
- Laissez le champ URL to purge complètement vide.
- Cliquez sur Purge.
- La confirmation indique « Full cache purged ».
Un vidage complet du cache vide chaque objet mis en cache pour le site à chaque emplacement de périphérie. Jusqu'à ce que chaque URL soit demandée à nouveau, chaque visiteur est servi depuis votre origine, donc l'origine subit une rafale de trafic et le premier visiteur de chaque page attend un aller-retour complet. Sur un site très fréquenté, préférez vider le cache des URLs spécifiques que vous avez modifiées.
Chaque vidage du cache que vous exécutez est enregistré dans le journal d'activité du compte avec l'URL ou un marqueur de zone complète, afin que vous puissiez voir qui a vidé quoi et quand.
Durées de vie du cache et interactions
La carte Cache TTLs, sur la même page, contrôle combien de temps le contenu survit sans un vidage du cache :
| Paramètre | Ce qu'il contrôle | Défaut |
|---|---|---|
| Edge TTL (seconds) | Combien de temps la périphérie conserve une copie avant de récupérer à nouveau depuis votre origine | 3600 (1 heure) |
| Browser TTL (seconds) | Combien de temps le navigateur d'un visiteur conserve sa propre copie locale | 3600 (1 heure) |
Les deux sont indépendants, et c'est la source la plus commune de confusion. Un vidage du cache efface la périphérie. Cela ne peut pas atteindre le cache d'un navigateur visiteur. Si vous videz le cache et que vous voyez toujours l'ancienne version vous-même, vous regardez presque certainement votre propre cache de navigateur.
Pour l'exclure, chargez la page dans une fenêtre privée ou incognito, ou effectuez un rechargement forcé. Si la fenêtre privée affiche la nouvelle version, le vidage du cache a fonctionné et vous attendez simplement votre propre navigateur et les navigateurs d'autres visiteurs, qui se rafraîchiront une fois que leur TTL de navigateur expire.
Si vous publiez fréquemment et que vous ne pouvez pas versionner les noms de fichiers, réduisez le Browser TTL à quelque chose de court (quelques minutes) et laissez le Edge TTL long. Vous conservez la plupart des avantages de la périphérie tout en donnant aux visiteurs une fenêtre beaucoup plus courte pendant laquelle ils peuvent être bloqués sur une ancienne copie.
Optimisation des images et vidage du cache
Si On-the-fly image optimisation est activée, la périphérie stocke le dérivé optimisé de chaque image aux côtés de l'original. Vider le cache de l'URL de l'image efface également le dérivé, donc une image remplacée est réoptimisée à sa prochaine demande. Il n'y a pas de vidage du cache séparé pour les images optimisées.
Il en va de même pour Serve WebP to supported browsers : la variante WebP vit sous la même URL et est effacée par le même vidage du cache.
Dépannage
« CDN not provisioned for this site. » Le site n'a pas encore de zone de périphérie. Activez d'abord le CDN et attendez la fin de l'approvisionnement du certificat.
« Purge failed. » La demande de vidage du cache n'a pas atteint la périphérie. Attendez un moment et réessayez. S'il continue d'échouer, la zone de périphérie peut être en cours d'approvisionnement ; vérifiez que la page affiche la bannière CDN is on.
J'ai vidé le cache et la page est toujours ancienne. Vérifiez d'abord dans une fenêtre privée. Si une fenêtre privée affiche également l'ancienne version, confirmez que vous avez vidé le cache de l'URL exacte, en incluant toute barre oblique de fin et chaîne de requête, puis essayez un vidage complet du cache.
Seuls certains visiteurs voient la mise à jour. Leurs navigateurs sont toujours dans le TTL du navigateur. Rien n'est mal : ils récupéreront la nouvelle version quand celui-ci expire, ou immédiatement lors d'un rechargement forcé.
L'origine s'est effondrée après un vidage complet du cache. C'est la rafale de trafic non mis en cache décrite ci-dessus. Augmentez le TTL de périphérie, et la prochaine fois, videz uniquement les URLs que vous avez modifiées. Improving Website Speed couvre la façon de rendre l'origine elle-même plus résiliente.
Si un vidage du cache réussit mais que la périphérie continue de servir du contenu ancien pendant plus de quelques minutes, envoyez un email à support@kapsulehost.com avec l'URL exacte et l'heure à laquelle vous avez vidé le cache.