Cómo deshabilitar el almacenamiento en caché de CDN
- Se aplica a:
- Experience Manager as a Cloud Service
- Temas:
- Caché de CDN
Creado para:
- Principiante
- Administrador
- Desarrollador
Obtenga información sobre cómo deshabilitar el almacenamiento en caché de respuestas HTTP en la CDN de AEM as a Cloud Service. El almacenamiento en caché de las respuestas está controlado por Cache-Control, Surrogate-Control o Expires encabezados de caché de respuestas HTTP.
Estos encabezados de caché generalmente se establecen en configuraciones vhost de AEM Dispatcher mediante mod_headers, pero también se pueden establecer en código Java™ personalizado que se ejecuta en AEM Publish.
Comportamiento de almacenamiento en caché predeterminado
El almacenamiento en caché de las respuestas HTTP en la CDN de AEM as a Cloud Service está controlado por los siguientes encabezados de respuesta HTTP desde el origen Cache-Control, Surrogate-Control o Expires. Las respuestas de origen que contienen private, no-cache o no-store en Cache-Control no se almacenan en caché.
Revise el comportamiento de almacenamiento en caché predeterminado para AEM Publish y Author cuando se implemente un proyecto de AEM basado en el tipo de archivo del proyecto de AEM.
Deshabilitar almacenamiento en caché
Desactivar el almacenamiento en caché puede tener un impacto negativo en el rendimiento de la instancia de AEM as a Cloud Service, por lo que tenga cuidado al desactivar el comportamiento predeterminado del almacenamiento en caché.
Sin embargo, hay algunos escenarios en los que puede que desee deshabilitar el almacenamiento en caché, como:
- Desarrollar una nueva función y desea ver los cambios inmediatamente.
- El contenido es seguro (solo para usuarios autenticados) o dinámico (carro de compras, detalles de pedidos) y no debe almacenarse en caché.
Para deshabilitar el almacenamiento en caché, puede actualizar los encabezados de caché de dos formas.
- Configuración de vhost de Dispatcher: Solo disponible para publicación en AEM.
- Código Java™ personalizado: disponible tanto para publicación como para autor en AEM.
Revisemos cada una de estas opciones.
Configuración de vhost de Dispatcher
Esta opción es el método recomendado para deshabilitar el almacenamiento en caché, pero solo está disponible para AEM Publish. Para actualizar los encabezados de caché, utilice el módulo mod_headers y la directiva <LocationMatch> en el archivo vhost del servidor HTTP de Apache. La sintaxis general es la siguiente:
<LocationMatch "$URL$ || $URL_REGEX$">
# Removes the response header of this name, if it exists. If there are multiple headers of the same name, all will be removed.
Header unset Cache-Control
Header unset Surrogate-Control
Header unset Expires
# Instructs the Browser and the CDN to not cache the response.
Header always set Cache-Control "private"
# Instructs only the CDN to not cache the response.
Header always set Surrogate-Control "private"
</LocationMatch>
Ejemplos
Para deshabilitar el almacenamiento en caché de CDN de los tipos de contenido CSS para algunos fines de solución de problemas, siga estos pasos.
Tenga en cuenta que, para omitir la caché CSS existente, se requiere un cambio en el archivo CSS para generar una nueva clave de caché para el archivo CSS.
-
En su proyecto de AEM, busque el archivo vhost deseado en el directorio
dispatcher/src/conf.d/available_vhosts. -
Actualice el archivo vhost (p. ej.
wknd.vhost) de la siguiente manera:<LocationMatch "^/etc.clientlibs/.*\.(css)$"> # Removes the response header of this name, if it exists. If there are multiple headers of the same name, all will be removed. Header unset Cache-Control Header unset Expires # Instructs the Browser and the CDN to not cache the response. Header always set Cache-Control "private" </LocationMatch>Los archivos vhost del directorio
dispatcher/src/conf.d/enabled_vhostsson symlinks a los archivos del directoriodispatcher/src/conf.d/available_vhosts, así que asegúrese de crear enlaces simbólicos si no los hay. -
Implemente los cambios de vhost en el entorno de AEM as a Cloud Service deseado mediante Cloud Manager - Canalización de configuración de nivel web o Comandos RDE.
Código Java™ personalizado
Esta opción está disponible tanto para Publicación en AEM como para Autor. Para actualizar los encabezados de caché, utilice el objeto SlingHttpServletResponse en el código Java™ personalizado (servlet Sling, filtro servlet Sling). La sintaxis general es la siguiente:
response.setHeader("Cache-Control", "private");