CDN 캐시를 제거하는 방법

AEM as a Cloud Service CDN에서 캐시된 HTTP 응답을 제거하거나 제거하는 방법을 알아봅니다. API 토큰 제거 ​라는 셀프서비스 기능을 사용하여 특정 리소스, 리소스 그룹 및 전체 캐시에 대한 캐시를 제거할 수 있습니다.

이 자습서에서는 셀프 서비스 기능을 사용하여 샘플 AEM WKND 사이트의 CDN 캐시를 제거하기 위해 API 토큰 제거를 설정하고 사용하는 방법에 대해 알아봅니다.

캐시 무효화와 명시적 제거 비교

CDN에서 캐시된 리소스를 제거하는 방법에는 두 가지가 있습니다.

캐시된 리소스가 CDN 캐시에서 제거되면 동일한 리소스에 대한 다음 요청은 원본 서버에서 최신 버전을 가져옵니다.

API 토큰 제거 설정

CDN 캐시를 제거하기 위해 API 토큰 제거를 설정하는 방법에 대해 알아보겠습니다.

CDN 규칙 구성

Purge API 토큰은 AEM 프로젝트 코드에 CDN 규칙을 구성하여 만듭니다.

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev", "stage", "prod"]
data:
  authentication: # The main authentication configuration
    authenticators: # The list of authenticators
       - name: purge-auth # The name of the authenticator
         type: purge  # The type of the authenticator, must be purge
         purgeKey1: ${{CDN_PURGEKEY_081324}} # The first purge key, must be referenced by the Cloud Manager secret-type environment variable name ${{CDN_EDGEKEY_073124}}
         purgeKey2: ${{CDN_PURGEKEY_111324}} # The second purge key, must be referenced by the Cloud Manager secret-type environment variable name ${{CDN_EDGEKEY_111324}}. It is used for the rotation of secrets without any interruptions.
    rules: # The list of authentication rules
       - name: purge-auth-rule # The name of the rule
         when: { reqProperty: tier, equals: "publish" } # The condition when the rule should be applied
         action: # The action to be taken when the rule is applied
           type: authenticate # The type of the action, must be authenticate
           authenticator: purge-auth # The name of the authenticator to be used, must match the name from the above authenticators list

위의 규칙에서 purgeKey1과(와) purgeKey2은(는) 중단 없이 암호 회전을 지원하기 위해 처음부터 추가됩니다. 그러나 purgeKey1로만 시작하여 나중에 암호를 회전할 때 purgeKey2을(를) 추가할 수 있습니다.

Cloud Manager 환경 변수 만들기

그런 다음 Cloud Manager 환경 변수를 만들어 제거 API 토큰 값을 저장합니다.

CDN 규칙 배포

마지막으로 Cloud Manager 파이프라인을 사용하여 구성된 CDN 규칙을 AEM as a Cloud Service 환경에 배포합니다.

제거 API 토큰 사용

CDN 캐시를 제거하려면 제거 API 토큰으로 AEM 서비스별 도메인 URL을 호출합니다. 캐시를 제거하는 구문은 다음과 같습니다.

PURGE <URL> HTTP/1.1
Host: <AEM_SERVICE_SPECIFIC_DOMAIN>
X-AEM-Purge-Key: <PURGE_API_TOKEN>
X-AEM-Purge: <PURGE_TYPE>
Surrogate-Key: <SURROGATE_KEY>

위치:

특정 리소스에 대한 캐시 제거

이 예에서 curl 명령은 AEM as a Cloud Service 환경에 배포된 WKND 사이트의 /us/en.html 리소스에 대한 캐시를 삭제합니다.

curl -X PURGE "https://publish-p46652-e1315806.adobeaemcloud.com/us/en.html" \
-H "X-AEM-Purge-Key: 123456789" \
-H "X-AEM-Purge: hard"

제거에 성공하면 200 OK 응답이 JSON 콘텐츠와 함께 반환됩니다.

{ "status": "ok", "id": "1000098-1722961031-13237063" }

리소스 그룹에 대한 캐시 제거

이 예제에서 curl 명령은 서로게이트 키가 wknd-assets인 리소스 그룹의 캐시를 삭제합니다. Surrogate-Key 응답 헤더가 wknd.vhost에 설정되어 있습니다. 예:

<VirtualHost *:80>
    ...

    # Core Component Image Component: long-term caching (30 days) for immutable URLs, background refresh to avoid MISS
    <LocationMatch "^/content/.*\.coreimg.*\.(?i:jpe?g|png|gif|svg)$">
        Header set Cache-Control "max-age=2592000,stale-while-revalidate=43200,stale-if-error=43200,public,immutable" "expr=%{REQUEST_STATUS} < 400"
        # Set Surrogate-Key header to group the cache of WKND assets, thus it can be flushed independtly
        Header set Surrogate-Key "wknd-assets"
        Header set Age 0
    </LocationMatch>

    ...
</VirtualHost>

curl -X PURGE "https://publish-p46652-e1315806.adobeaemcloud.com" \
-H "Surrogate-Key: wknd-assets" \
-H "X-AEM-Purge-Key: 123456789" \
-H "X-AEM-Purge: hard"

제거에 성공하면 200 OK 응답이 JSON 콘텐츠와 함께 반환됩니다.

{ "wknd-assets": "10027-1723478994-2597809-1" }

전체 캐시 제거

이 예에서 curl 명령을 사용하면 AEM as a Cloud Service 환경에 배포된 샘플 WKND 사이트에서 전체 캐시가 제거됩니다.

curl -X PURGE "https://publish-p46652-e1315806.adobeaemcloud.com/" \
-H "X-AEM-Purge-Key: 123456789" \
-H "X-AEM-Purge: all"

제거에 성공하면 200 OK 응답이 JSON 콘텐츠와 함께 반환됩니다.

{"status":"ok"}

캐시 제거 확인

캐시 제거를 확인하려면 웹 브라우저에서 리소스 URL에 액세스하고 응답 헤더를 검토합니다. X-Cache 헤더 값은 MISS이어야 합니다.