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.
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
Cuando NO hay configuraciones personalizadas presentes, se utilizan los valores predeterminados. En la siguiente captura de pantalla, puede ver el comportamiento de almacenamiento en caché predeterminado para AEM Publish y Author cuando se implementa un Arquetipo de proyecto de AEM basado en mynewsite proyecto de AEM.
Revise Publicación de AEM - Duración predeterminada de la caché y Autor de AEM - Duración predeterminada de la caché 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) en AEM Publish y algunos tipos de contenido (JS, CSS) en AEM Author.
Habilitar almacenamiento en caché
Para cambiar el comportamiento predeterminado del 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 habilitar 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 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.
- max-age: este atributo controla el TTL o el "tiempo de vida" del contenido de la respuesta en segundos.
- stale-while-revalidate: este atributo controla el tratamiento de stale state del contenido de respuesta en la capa de CDN cuando la solicitud recibida se encuentra dentro del período especificado en segundos. El estado obsoleto es el período de tiempo después de que caduque el TTL y antes de que se vuelva a validar la respuesta.
- stale-if-error: este atributo controla el tratamiento de stale state del contenido de respuesta en la capa de CDN cuando el servidor de origen no está disponible y la solicitud recibida se encuentra dentro del período especificado en segundos.
Revise los detalles de inactividad y revalidación para obtener más información.