CDN 캐싱을 활성화하는 방법

AEM as a Cloud Service CDN에서 HTTP 응답 캐싱을 활성화하는 방법을 알아봅니다. 응답 캐싱은 Cache-Control, Surrogate-Control 또는 Expires HTTP 응답 캐시 헤더에 의해 제어됩니다.

이러한 캐시 헤더는 일반적으로 mod_headers을(를) 사용하여 AEM Dispatcher vhost 구성에서 설정되지만 AEM Publish 자체에서 실행되는 사용자 지정 Java™ 코드에서도 설정할 수 있습니다.

기본 캐싱 동작

사용자 지정 구성이 없으면 기본값이 사용됩니다. AEM Project Archetype 기반 mynewsite AEM 프로젝트가 배포되면 다음 스크린샷에서 AEM Publish 및 작성자에 대한 기본 캐싱 동작을 볼 수 있습니다.

자세한 내용은 AEM Publish - 기본 캐시 수명 및 AEM 작성자 - 기본 캐시 수명을 검토하십시오.

요약하면, AEM as a Cloud Service은 AEM Publish의 대부분의 콘텐츠 유형(HTML, JSON, JS, CSS 및 Assets)과 AEM Author의 일부 콘텐츠 유형(JS, CSS)을 캐시합니다.

캐싱 활성화

기본 캐싱 동작을 변경하려면 두 가지 방법으로 캐시 헤더를 업데이트할 수 있습니다.

이러한 각 옵션을 검토해 보겠습니다.

Dispatcher vhost 구성

이 옵션은 캐싱을 활성화하는 데 권장되는 접근 방식이지만, AEM Publish에만 사용할 수 있습니다. 캐시 헤더를 업데이트하려면 Apache HTTP Server의 vhost 파일에서 mod_headers 모듈 및 <LocationMatch> 지시문을 사용합니다. 일반 구문은 다음과 같습니다.

<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>

다음은 각 header ​의 목적과 헤더에 적용할 수 있는 attributes ​을 요약합니다.

자세한 내용은 안정성 및 유효성 재검사 세부 정보를 검토하십시오.

예

부실 상태 처리 없이 HTML 콘텐츠 형식 ​의 웹 브라우저 및 CDN 캐시 수명을 10분(으)로 늘리려면 다음 단계를 수행합니다.

그러나 웹 브라우저 및 CDN 캐시 수명에 대해 다른 값을 갖기 위해 위의 예에서 Surrogate-Control 헤더를 사용할 수 있습니다. 마찬가지로 특정 날짜 및 시간에 캐시를 만료하려면 Expires 헤더를 사용할 수 있습니다. 또한 stale-while-revalidate 및 stale-if-error 특성을 사용하여 응답 콘텐츠의 부실 상태 처리를 제어할 수 있습니다. AEM WKND 프로젝트에 참조 부실 상태 처리 CDN 캐시 구성이 있습니다.

마찬가지로 다른 콘텐츠 유형(JSON, JS, CSS 및 Assets)의 캐시 헤더도 업데이트할 수 있습니다.

사용자 지정 Java™ 코드

이 옵션은 AEM Publish과 작성자 모두에 사용할 수 있습니다. 그러나 AEM Author에서 캐싱을 활성화하고 기본 캐싱 동작을 유지하는 것은 권장되지 않습니다.

캐시 헤더를 업데이트하려면 사용자 지정 Java™ 코드의 HttpServletResponse 개체(Sling 서블릿, Sling 서블릿 필터)를 사용합니다. 일반 구문은 다음과 같습니다.

// 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");