Purgar elimina la copia de su contenido que se guarda en el edge, de modo que el siguiente visitante recibe una versión recién obtenida de su origen. Es lo que hace cuando ha publicado un cambio y sigue apareciendo la versión antigua.
La caché es lo que hace rápido al CDN, y también es la razón por la que un cambio que acaba de hacer puede no aparecer de inmediato. En lugar de reducir a cero la duración de la caché, manténgala larga y purgue cuando lo necesite. Esta guía cubre ambas cosas, además de cómo distinguir una caché del edge de una caché del navegador antes de buscar en el sitio equivocado.
Cuándo necesita purgar
Purgue después de cambiar algo que los visitantes obtienen mediante una URL:
- Ha sustituido un archivo CSS o JavaScript y se sigue sirviendo el antiguo.
- Ha subido una nueva versión de una imagen sobre un nombre de archivo ya existente.
- Ha corregido un error en una página y quiere que la versión defectuosa desaparezca en todo el mundo, ya.
- Ha cambiado el contenido de una página y no puede esperar a que caduque el TTL del edge.
No necesita purgar cuando ha añadido una página totalmente nueva o un nombre de archivo nuevo. No hay nada en caché para una URL que nunca se ha solicitado.
Si versiona los nombres de archivo de sus recursos (style.a1b2c3.css en lugar de style.css), rara vez tendrá que purgar. Un nombre de archivo nuevo es una URL nueva, así que se obtiene de nuevo desde su origen y se guarda en caché con su propia clave.
Dónde está el control de purga
- Inicie sesión en KPanel.
- Haga clic en Sitios web en la barra lateral izquierda y, después, en su sitio.
- En el menú del sitio, abra Rendimiento y luego Kapsule CDN.
- Desplácese hasta la tarjeta Purgar caché.
La dirección directa es /websites/<site-id>/cdn.
El control de purga solo aparece cuando el CDN está activado para el sitio. Si la página muestra el aviso CDN está desactivado en este sitio, o le pide conectar un dominio personalizado, todavía no hay nada que purgar en el edge. Activar Kapsule CDN en su sitio indica exactamente qué planes lo incluyen.
Purgar una sola URL
- En la tarjeta Purgar caché, escriba la URL pública completa en el campo URL a limpiar (dejar en blanco para todo el sitio). El texto de ejemplo del campo muestra la forma esperada:
https://your-domain.tld/path. - Haga clic en Purgar.
- Aparece una confirmación que indica que se ha purgado la URL que introdujo.
Use la URL exacta que solicitaría un visitante, incluido el esquema (https://), el host y la ruta. La purga se compara con la URL, así que https://example.com/about y https://example.com/about/ son dos entradas de caché distintas, igual que la misma página con una cadena de consulta añadida.
Purgar una sola URL es el primer paso correcto cuando sabe exactamente qué ha cambiado. Es instantáneo y deja intacto el resto de la caché, así que el resto del sitio sigue siendo rápido.
Purgar todo el sitio
- Deje el campo URL a limpiar completamente en blanco.
- Haga clic en Purgar.
- La confirmación dice "Caché completo limpiado."
Una purga completa vacía todos los objetos en caché del sitio en todas las ubicaciones del edge. Hasta que cada URL se vuelva a solicitar, todos los visitantes se sirven desde su origen, así que el origen recibe un pico de tráfico y el primer visitante de cada página espera un viaje de ida y vuelta completo. En un sitio con mucho tráfico, es preferible purgar solo las URL concretas que ha cambiado.
Cada purga que ejecuta queda registrada en el registro de actividad de la cuenta con la URL o una marca de zona completa, para que pueda ver quién purgó qué y cuándo.
Duración de la caché y cómo interactúan
La tarjeta TTLs de caché, en la misma página, controla cuánto tiempo sobrevive el contenido sin una purga:
| Ajuste | Qué controla | Valor predeterminado |
|---|---|---|
| TTL de borde (segundos) | Cuánto tiempo conserva el edge una copia antes de volver a obtenerla de su origen | 3600 (1 hora) |
| TTL de navegador (segundos) | Cuánto tiempo conserva el navegador de un visitante su propia copia local | 3600 (1 hora) |
Los dos son independientes, y esta es con diferencia la causa de confusión más habitual. Una purga borra el edge. No puede llegar al navegador de un visitante. Si purga y sigue viendo la versión antigua, casi con toda seguridad está viendo la caché de su propio navegador.
Para descartarlo, cargue la página en una ventana privada o de incógnito, o haga una recarga forzada. Si la ventana privada muestra la nueva versión, la purga ha funcionado y solo está esperando a su propio navegador y a los de otros visitantes, que se actualizarán cuando caduque su TTL de navegador.
Si publica con frecuencia y no puede versionar los nombres de archivo, reduzca el TTL de navegador a algo corto (unos minutos) y deje largo el TTL de borde. Conserva la mayor parte de la ventaja del edge y da a los visitantes un margen mucho más corto en el que pueden quedarse con una copia antigua.
Optimización de imágenes y purga
Si la Optimización de imágenes sobre la marcha está activada (una función de Kapsule CDN+), el edge guarda la versión optimizada de cada imagen junto al original. Purgar la URL de la imagen borra también la versión optimizada, así que una imagen sustituida se vuelve a optimizar en su siguiente solicitud. No existe una purga aparte para las imágenes optimizadas.
Lo mismo se aplica a Servir WebP a navegadores compatibles: la variante WebP está bajo la misma URL y se borra con la misma purga.
Solución de problemas
"CDN no aprovisionado para este sitio." El sitio aún no tiene una zona de edge. Active primero el CDN y espere a que termine de aprovisionarse el certificado.
"Error al purgar." La solicitud de purga no llegó al edge. Espere un momento y vuelva a intentarlo. Si sigue fallando, puede que la zona de edge todavía se esté aprovisionando; compruebe que la página muestra el aviso CDN está activado.
He purgado y la página sigue siendo la antigua. Compruebe primero en una ventana privada. Si una ventana privada también muestra la versión antigua, confirme que ha purgado la URL exacta, incluida cualquier barra final y cadena de consulta, y después pruebe una purga completa.
Solo algunos visitantes ven la actualización. Sus navegadores siguen dentro del TTL de navegador. No pasa nada: recibirán la nueva versión cuando caduque, o de inmediato con una recarga forzada.
El origen se cayó tras una purga completa. Es el pico de tráfico sin caché descrito arriba. Aumente el TTL del edge y, la próxima vez, purgue solo las URL que hayan cambiado. Mejorar la velocidad de su sitio web explica cómo hacer más resistente el propio origen.
Si una purga se completa pero el edge sigue sirviendo contenido antiguo durante más de unos minutos, escriba a support@kapsulehost.com con la URL exacta y la hora a la que purgó.