캐시 키 사용

이 페이지에서는 Cloud CDN 캐시 키를 맞춤설정하는 방법을 설명합니다.

캐시 키 구성을 변경한 경우 새로운 요청이 이전 캐시 키 항목과 다른 캐시 키를 사용하기 시작하면 캐시 적중률이 갑자기 저하될 수 있습니다. 마찬가지로 캐시 키 작성자를 변경하더라도 새로운 요청이 이전 캐시 키와 동일한 키를 사용하면 캐시된 항목이 무효화되지 않습니다. 기존의 캐시된 항목을 무효화하려면 캐시된 콘텐츠 무효화를 참조하세요.

시작하기 전에

이 페이지는 사용자가 Cloud CDN, Cloud CDN 캐시 키, 부하 분산된 백엔드 서비스를 이해하고 있다고 전제합니다. 계속 진행하기 전에 해당 페이지를 검토하는 것이 좋습니다.

백엔드 서비스에 Cloud CDN 사용 설정 및 캐시 키 맞춤설정

다음 안내를 따라 부하 분산된 백엔드 서비스에 CDN을 활성화하고 구성요소를 한 개 제외하여 캐시 키를 맞춤설정할 수 있습니다. 원본으로 사용할 부하 분산기가 아직 없는 경우 부하 분산기를 만드는 방법은 외부 HTTP(S) 부하 분산 문서를 참조하세요.

콘솔

  1. Google Cloud Console에서 Cloud CDN 페이지로 이동합니다.

    Cloud CDN 페이지로 이동

  2. 원본 추가를 클릭합니다.
  3. 원본 풀다운 메뉴에서 원본 선택을 클릭합니다.
  4. CDN을 사용 설정할 원본을 선택합니다.
  5. 원본 행에서 구성을 클릭합니다.
  6. 이 백엔드 서비스의 캐시 키에서 생략할 필드의 체크박스를 선택 취소합니다.
  7. 저장을 클릭합니다.
  8. 추가를 클릭합니다.

gcloud

이 백엔드 서비스의 캐시 키에서 해당 매개 변수를 제외하려면 신고(선택사항)를 한 개 이상 지정합니다.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-cdn

선택적 플래그:

  • --no-cache-key-include-protocol
  • --no-cache-key-include-host
  • --no-cache-key-include-query-string

프로토콜, 호스트, 쿼리 문자열을 다시 추가하도록 캐시 키 업데이트

기본적으로 Cloud CDN을 사용하도록 구성된 백엔드 서비스는 캐시 키에 요청 URI의 모든 구성 요소를 포함합니다. 앞에서 구성요소를 한 개 이상 제외하도록 지정한 경우에도 다음 단계를 따라 구성요소를 다시 포함할 수 있습니다.

다음 안내를 따라 이미 CDN을 사용하고 있는 기존 백엔드 서비스의 캐시 키에 프로토콜, 호스트, 쿼리 문자열을 다시 추가할 수 있습니다.

콘솔

  1. Google Cloud Console에서 Cloud CDN 페이지로 이동합니다.

    Cloud CDN 페이지로 이동

  2. 부하 분산기 행에서 메뉴 를 클릭한 후 수정을 클릭합니다.
  3. 수정하려는 백엔드 서비스의 행에서 구성을 클릭합니다.
  4. 캐시 키에서 커스텀을 선택합니다.
  5. 프로토콜, 호스트, 쿼리 문자열 체크박스를 선택합니다.
  6. 쿼리 문자열 매개변수 필드를 비워 둡니다.
  7. 저장을 클릭합니다.
  8. 업데이트를 클릭합니다.

gcloud

구성요소 한 개만 다시 추가하려면 해당 플래그만 지정합니다. 지정되지 않은 플래그는 변경되지 않습니다.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-protocol \
    --cache-key-include-host \
    --cache-key-include-query-string

쿼리 문자열의 포함 또는 제외 목록을 사용하도록 캐시 키 업데이트

다음 안내를 따라 쿼리 문자열 매개변수를 통해 포함 목록 또는 제외 목록을 사용하도록 CDN 캐시 키를 설정합니다.

콘솔

  1. Google Cloud Console에서 Cloud CDN 페이지로 이동합니다.

    Cloud CDN 페이지로 이동

  2. 부하 분산기 행에서 메뉴 를 클릭한 후 수정을 클릭합니다.
  3. 수정하려는 백엔드 서비스의 행에서 구성을 클릭합니다.
  4. 캐시 키에서 커스텀을 선택합니다.
  5. 쿼리 문자열 확인란이 선택되어 있는지 확인합니다.
  6. 캐시 키에 포함할 쿼리 문자열 매개변수를 지정하려면 선택한 문자열만 포함(whitelist)을 선택합니다.

    나열한 매개변수를 제외한 모든 쿼리 문자열 매개변수가 캐시 키에 포함되도록 지정하려면 선택한 문자열을 제외한 모든 문자열 포함(blacklist)을 선택합니다.

  7. 쿼리 문자열 매개변수 필드에 쉼표로 구분된 문자열 목록을 입력합니다.

  8. 저장을 클릭합니다.

  9. 업데이트를 클릭합니다.

gcloud

user 문자열을 포함 목록으로 설정하려면 이 명령어를 사용합니다.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

user 문자열을 제외 목록에 추가하려면 이 명령어를 사용합니다.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

다음 단계

  • Cloud CDN이 캐시에서 응답을 제공하고 있는지 확인하려면 로그 보기를 참조하세요.