Cómo habilitar el almacenamiento en caché de CDN

Obtenga información sobre cómo habilitar 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.

AEM Estos encabezados de caché generalmente se establecen en configuraciones de host de Dispatcher AEM usando mod_headers, pero también se pueden establecer en el código Java™ personalizado que se ejecuta en el propio Publish.

Comportamiento de almacenamiento en caché predeterminado

Cuando NO hay configuraciones personalizadas presentes, se utilizan los valores predeterminados. AEM En la siguiente captura de pantalla, puede ver el comportamiento de almacenamiento en caché predeterminado para el autor y el Publish AEM AEM de la cuando se implementa un proyecto de tipo de archivo basado en el tipo de archivodel proyecto mynewsite.

AEM Revise Publish AEM - Duración predeterminada de la caché y Autor de la caché predeterminada para obtener más información

En resumen, AEM as a Cloud Service almacena en caché la mayoría de los tipos de contenido (HTML, JSON, JS, CSS y Assets AEM) en Publish AEM y algunos tipos de contenido (JS, CSS) en Author.

Habilitar almacenamiento en caché

Para cambiar el comportamiento predeterminado del almacenamiento en caché, puede actualizar los encabezados de caché de dos formas.

Revisemos cada una de estas opciones.

Configuración de vhost de Dispatcher

AEM Esta opción es el método recomendado para habilitar el almacenamiento en caché; sin embargo, solo está disponible para el Publish de la. 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 web browser and CDN to cache the response for 'max-age' value (XXX) seconds. The 'stale-while-revalidate' and 'stale-if-error' attributes controls the stale state treatment at CDN layer.
    Header set Cache-Control "max-age=XXX,stale-while-revalidate=XXX,stale-if-error=XXX"

    # Instructs the CDN to cache the response for 'max-age' value (XXX) seconds. The 'stale-while-revalidate' and 'stale-if-error' attributes controls the stale state treatment at CDN layer.
    Header set Surrogate-Control "max-age=XXX,stale-while-revalidate=XXX,stale-if-error=XXX"

    # Instructs the web browser and CDN to cache the response until the specified date and time.
    Header set Expires "Sun, 31 Dec 2023 23:59:59 GMT"
</LocationMatch>

A continuación se resume el propósito de cada encabezado y los atributos aplicables para el encabezado.

Revise los detalles de inactividad y revalidación para obtener más información.

Ejemplos

Para aumentar la duración de la caché del explorador web y la red de distribución de contenido (CDN) de tipo de contenido de HTML a 10 minutos sin tratamiento de estado obsoleto, siga estos pasos:

Sin embargo, para tener valores diferentes para la duración de la caché del explorador web y la CDN, puede utilizar el encabezado Surrogate-Control del ejemplo anterior. Del mismo modo, para que la caché caduque en una fecha y hora específicas, puede utilizar el encabezado Expires. Además, con los atributos stale-while-revalidate y stale-if-error, puede controlar el tratamiento del estado antiguo del contenido de la respuesta. AEM El proyecto de WKND de WKND tiene una configuración de caché de CDN tratamiento de estado obsoleto de referencia.

Del mismo modo, también puede actualizar los encabezados de caché para otros tipos de contenido (JSON, JS, CSS y Assets).

Código Java™ personalizado

AEM Esta opción está disponible tanto para Publish como para Autor de la. AEM Sin embargo, no se recomienda habilitar el almacenamiento en caché en el Autor de la y mantener el comportamiento de almacenamiento en caché predeterminado.

Para actualizar los encabezados de caché, utilice el objeto HttpServletResponse en el código Java™ personalizado (servlet Sling, filtro servlet Sling). La sintaxis general es la siguiente:

// Instructs the web browser and CDN to cache the response for 'max-age' value (XXX) seconds. The 'stale-while-revalidate' and 'stale-if-error' attributes controls the stale state treatment at CDN layer.
response.setHeader("Cache-Control", "max-age=XXX,stale-while-revalidate=XXX,stale-if-error=XXX");

// Instructs the CDN to cache the response for 'max-age' value (XXX) seconds. The 'stale-while-revalidate' and 'stale-if-error' attributes controls the stale state treatment at CDN layer.
response.setHeader("Surrogate-Control", "max-age=XXX,stale-while-revalidate=XXX,stale-if-error=XXX");

// Instructs the web browser and CDN to cache the response until the specified date and time.
response.setHeader("Expires", "Sun, 31 Dec 2023 23:59:59 GMT");