외부 원본으로 Cloud CDN 설정

이 가이드에서는 예시를 사용하여 인터넷 네트워크 엔드포인트 그룹(NEG)에서 커스텀 원본 사용의 기본사항을 안내합니다. 커스텀 원본은 Google Cloud 외부에 있는 인터넷 엔드포인트입니다. 인터넷 NEG를 외부 HTTP(S) 부하 분산기의 백엔드로 사용하고 Cloud CDN 캐싱을 사용하여 성능을 개선할 수 있습니다.

이 가이드에서는 backend.example.com의 커스텀 원본 서버로 프록시 처리하는 Cloud CDN 사용 설정 백엔드 서비스로 전역 외부 HTTP(S) 부하 분산기를 구성하는 방법을 단계별로 살펴봅니다.

예시에서는 부하 분산기가 클라이언트의 HTTPS 요청을 수락하고 해당 요청을 HTTP/2를 사용하여 커스텀 원본에 프록시 처리합니다. 이 예시에서는 원본이 HTTP/2를 지원한다고 가정합니다.

부하 분산기가 HTTP 또는 HTTP/2 요청을 수락하고 요청을 커스텀 원본으로 프록시 처리할 때 HTTPS를 사용하도록 구성할 수도 있습니다.

인터넷 NEG 설정에는 다음 활동이 포함됩니다.

  • 인터넷 NEG에서 인터넷 엔드포인트 정의
  • 인터넷 NEG를 백엔드 서비스의 백엔드로 추가
  • 외부 HTTP(S) 부하 분산기의 URL 맵을 구성하여 이 백엔드 서비스에 매핑할 사용자 트래픽 정의

시작하기 전에

이 가이드를 진행하기 전에 다음 사항을 숙지하세요.

선택사항: gcloud 설치

명령줄에서의 작업을 더 선호하는 경우 gcloud 명령줄 도구를 설치합니다. 도구에 대한 개념과 설치 정보는 gcloud 명령줄 도구 개요를 참조하세요.

이전에 gcloud 명령줄 도구를 실행한 적이 없다면 먼저 gcloud init을 실행하여 gcloud 디렉터리를 초기화합니다.

선택사항: 새 프로젝트 만들기

이 안내에 따라 작업을 수행하려면 프로젝트가 필요합니다. 아직 프로젝트가 없다면 지금 설정하세요.

resourcemanager.projects.create 권한이 있는 사용자는 이 안내 가이드의 나머지 부분을 수행하기 전에 새 프로젝트를 만드는 것이 좋습니다. 새 프로젝트를 만들면 이 가이드의 끝부분에서 수행하는 정리 작업이 간소화됩니다.

권한

이 가이드를 따르려면 인터넷 NEG를 만들고 프로젝트에서 외부 HTTP(S) 부하 분산기를 만들거나 수정해야 합니다. 이 작업을 수행하려면 프로젝트 소유자 또는 편집자이거나 아래 Compute Engine IAM 역할을 둘 다 보유해야 합니다.

작업 필요한 역할
부하 분산기 구성요소 생성 및 수정 네트워크 관리자
NEG 생성 및 수정 Compute 인스턴스 관리자

커스텀 원본으로 부하 분산기 구성

이 가이드에서는 인터넷 NEG를 구성하고 테스트하는 방법을 설명합니다.

설정 개요

이 섹션의 단계에서는 다음을 구성하는 방법을 설명합니다.

  • 인터넷 NEG를 만들고 INTERNET_IP_PORT 또는 INTERNET_FQDN_PORT 엔드포인트를 정의하는 네트워크 엔드포인트를 연결합니다.
  • 이 NEG를 외부 HTTP(S) 부하 분산기의 백엔드 서비스와 연결합니다.
  • 이 외부 HTTP(S) 부하 분산기에 전달 규칙을 추가합니다.

샘플 아키텍처는 다음과 같습니다.

커스텀 원본의 일반적인 사용 사례
커스텀 원본의 일반적인 사용 사례

다이어그램에서 www.example.com에는 부하 분산기 프런트엔드가 있으며 IP 주소는 120.1.1.1입니다. 캐시 부적중이 있으면 사용자 요청 /cart/id/1223515 HTTP/2를 통해 커스텀 원본에서 가져옵니다. 다른 모든 수신 트래픽은 Compute Engine VM이 있는 Google Cloud 백엔드 서비스 또는 URL 맵을 기반으로 백엔드 버킷으로 전달됩니다.

이 예시를 설정하려면 다음 리소스를 만듭니다.

  • IP 주소가 120.1.1.1인 전달 규칙은 수신 요청을 대상 프록시로 전달합니다.
    • 전달 규칙의 networkTierPREMIUM이어야 합니다.
  • 대상 프록시는 각 요청과 URL 맵을 대조해 요청에 맞는 백엔드 서비스를 결정합니다.
    • 커스텀 원본의 경우 대상 프록시는 TargetHttpProxy 또는 TargetHttpsProxy여야 합니다. 다음 예시에서는 TargetHttpsProxy를 사용합니다.
  • 백엔드 서비스에서 Cloud CDN을 사용 설정하면(선택사항) Cloud CDN 캐시에서 응답을 캐싱하고 제공할 수 있습니다.
  • 백엔드 서비스 구성은 트래픽을 인터넷 NEG 하나에 전달합니다. 이 인터넷 NEG에는 Cloud CDN 캐시 부적중이 있을 때 외부 HTTP(S) 부하 분산기가 트래픽을 전송하는 네트워크 엔드포인트가 포함됩니다.
  • 이 예시에는 커스텀 원본이 HTTP 요청의 Host 헤더에 특정 값을 예상할 때 필요한 사용자 정의 요청 헤더가 포함됩니다.

NEG 및 인터넷 엔드포인트 만들기

Console

  1. Google Cloud Console에서 네트워크 엔드포인트 그룹 페이지로 이동합니다.

    네트워크 엔드포인트 그룹 페이지로 이동

  2. 네트워크 엔드포인트 그룹 만들기를 클릭합니다.
  3. 네트워크 엔드포인트 그룹 이름을 example-fqdn-neg로 입력합니다.
  4. 네트워크 엔드포인트 그룹 유형네트워크 엔드포인트 그룹(인터넷)을 선택합니다.
  5. 기본 포트443을 입력합니다.
  6. 새 네트워크 엔드포인트정규화된 도메인 이름 및 포트를 선택합니다.
  7. FQDN에 backend.example.com을 입력합니다.
  8. 포트 유형기본값을 선택하고 포트 번호443인지 확인합니다.
  9. 만들기를 클릭합니다.

gcloud

  1. 인터넷 NEG를 만들고 --network-endpoint-typeinternet-fqdn-port로 설정합니다(호스트 이름과 원본에 도달할 수 있는 포트).

    gcloud compute network-endpoint-groups create example-fqdn-neg \
        --network-endpoint-type="internet-fqdn-port" --global
    
  2. NEG에 엔드포인트를 추가합니다. 포트를 지정하지 않았다면 백엔드 서비스에서 구성된 프로토콜에 따라 포트 선택 기본값이 포트 80(HTTP) 또는 443(HTTPS; HTTP/2)입니다. --global 플래그를 포함하는지 확인합니다.

    gcloud compute network-endpoint-groups update example-fqdn-neg \
        --add-endpoint="fqdn=backend.example.com,port=443" \
        --global
    
  3. 만든 인터넷 NEG를 다음과 같이 나열합니다.

    gcloud compute network-endpoint-groups list --global
    

    출력:

    NAME                LOCATION   ENDPOINT_TYPE        SIZE
    example-fqdn-neg    global     INTERNET_FQDN_PORT   1
    

  4. NEG 내 엔드포인트를 나열합니다.

    gcloud compute network-endpoint-groups list-network-endpoints example-fqdn-neg \
        --global
    

    출력:

    INSTANCE   IP_ADDRESS   PORT   FQDN
                                   backend.example.com
    

기존 부하 분산기 사용

다음 예시에서는 기존 부하 분산기를 업데이트합니다.

외부 HTTP(S) 부하 분산기가 없다면 이 섹션을 건너뛰고 새 부하 분산기 사용으로 이동합니다.

기존 부하 분산기에서 기본 서비스는 Google Cloud 서비스입니다. 이 예시에서는 cart/id/1223515의 모든 요청을 인터넷 NEG에 연결된 images 백엔드 서비스로 보내는 경로 일치자를 추가하여 기존 URL 맵을 수정합니다.

Console

백엔드 서비스 만들기 및 인터넷 NEG 추가

  1. Google Cloud Console에서 부하 분산 페이지로 이동합니다.

    부하 분산 페이지로 이동

  2. 기존 부하 분산기에 백엔드 서비스를 추가하려면 외부 HTTP(S) 부하 분산기를 선택하고 메뉴 를 클릭한 후 수정을 선택합니다.
  3. 백엔드 구성을 클릭합니다.
  4. 백엔드 서비스 및 백엔드 버킷 만들기 또는 선택 풀다운 메뉴에서 백엔드 서비스 > 백엔드 서비스 만들기를 선택합니다.
  5. 백엔드 서비스의 이름을 images로 설정합니다.
  6. 백엔드 유형인터넷 네트워크 엔드포인트 그룹을 선택합니다.
  7. 인터넷 NEG에 대해 부하 분산기에서 사용할 프로토콜을 선택합니다. 이 예시에서는 HTTP/2를 선택합니다.
  8. 새 백엔드 > 인터넷 네트워크 엔드포인트 그룹에서 example-fqdn-neg를 선택한 후 완료를 클릭합니다.
  9. Cloud CDN 사용 설정을 선택합니다.
  10. 기본 캐시 모드 설정과 TTL 설정을 유지합니다.
  11. 고급 구성커스텀 요청 헤더에서 헤더 추가를 클릭합니다.
    1. 헤더 이름Host를 입력합니다.
    2. 헤더 값backend.example.com을 입력합니다.
  12. 만들기를 클릭합니다.
  13. 계속하려면 창을 열어둡니다.

기존 URL 맵에 백엔드 서비스 연결

  1. 호스트 및 경로 규칙을 클릭합니다.
  2. 오른쪽 열의 첫 번째 행에는 Google Cloud 서비스가 있습니다. 이들 중 하나는 호스트경로의 기본 규칙 Any unmatched (default)로 이미 채워져 있습니다.
  3. 오른쪽 열에 images가 선택된 행이 있는지 확인합니다. 없다면 호스트 및 경로 규칙 추가를 클릭하고 images를 선택합니다. 다른 필드를 다음과 같이 채웁니다.
    1. 호스트*를 입력합니다.
    2. 경로/cart/id/1223515를 입력합니다.

검토 및 완료

  1. 검토 및 완료를 클릭합니다.
  2. 만들려던 설정과 현재 설정을 비교합니다.
  3. 모두 올바르게 표시되면 만들기를 클릭하여 외부 HTTP 부하 분산기를 만듭니다.

gcloud

  1. NEG의 새 백엔드 서비스를 만듭니다.

    gcloud compute backend-services create images \
       --global \
       --enable-cdn \
       --protocol=HTTP2
    
  2. 백엔드 서비스를 구성하여 커스텀 요청 헤더 Host: backend.example.com을 요청에 추가합니다.

    gcloud compute backend-services update images \
       --custom-request-header "Host: backend.example.com" --global
    
  3. backend-services add-backend 명령어를 사용하여 인터넷 NEG를 백엔드 서비스에 추가합니다.

    gcloud compute backend-services add-backend images \
      --network-endpoint-group "example-fqdn-neg" \
      --global-network-endpoint-group \
      --global
    
  4. 새 일치 규칙을 만들어 새 백엔드 서비스를 부하 분산기의 URL 맵에 연결하여 백엔드로 요청을 전달합니다.

    gcloud compute url-maps add-path-matcher EXAMPLE_URL_MAP \
      --default-service=GCP_SERVICE_EXAMPLE \
      --path-matcher-name=CUSTOM_ORIGIN_PATH_MATCHER_EXAMPLE \
      --backend-service-path-rules=/CART/ID/1223515=IMAGES
    

    다음을 바꿉니다.

    • EXAMPLE_URL_MAP: 기존 URL 맵의 이름
    • GCP_SERVICE_EXAMPLE: 기존 기본 백엔드 서비스 이름
    • CUSTOM_ORIGIN_PATH_MATCHER_EXAMPLE: 이 새 경로 규칙 이름
    • /CART/ID/1223515: 경로
    • IMAGES: 연결된 인터넷 NEG가 있는 새 백엔드 서비스의 이름

새 부하 분산기 사용

다음 예시에서는 인터넷 NEG를 기본(호스트, 경로) 서비스로 사용하는 외부 HTTP(S) 부하 분산기를 만듭니다.

수정할 기존 외부 HTTP(S) 부하 분산기가 이미 있으면 이 섹션을 건너뛰고 기존 부하 분산기 사용으로 이동합니다.

Console

백엔드 서비스 만들기 및 인터넷 NEG 추가

  1. Google Cloud Console에서 부하 분산 페이지로 이동합니다.

    부하 분산 페이지로 이동

  2. 부하 분산기 만들기를 클릭합니다.
  3. HTTP(S) 부하 분산에서 구성 시작을 클릭합니다.
  4. 인터넷에서 내 VM으로를 선택합니다.
  5. 새 부하 분산기의 이름을 입력합니다. 이 이름이 새 URL 맵의 이름이 됩니다. 이 예시에서는 example-url-map이라고 칭합니다.
  6. 백엔드 구성을 클릭합니다.
  7. 백엔드 서비스 및 백엔드 버킷 만들기 또는 선택 풀다운 메뉴에서 백엔드 서비스 > 백엔드 서비스 만들기를 선택합니다.
  8. 백엔드 서비스의 이름을 images로 설정합니다.
  9. 백엔드 유형인터넷 네트워크 엔드포인트 그룹을 선택합니다.
  10. 인터넷 NEG에 대해 부하 분산기에서 사용할 프로토콜을 선택합니다. 이 예시에서는 HTTP/2를 선택합니다.
  11. 새 백엔드 > 인터넷 네트워크 엔드포인트 그룹에서 example-fqdn-neg를 선택한 후 완료를 클릭합니다.
  12. Cloud CDN 사용 설정을 선택합니다.
  13. 고급 구성커스텀 요청 헤더에서 헤더 추가를 클릭합니다.
    1. 헤더 이름Host를 입력합니다.
    2. 헤더 값backend.example.com을 입력합니다.
  14. 만들기를 클릭합니다.
  15. 계속하려면 창을 열어둡니다.

새 URL 맵에 백엔드 서비스 연결

  1. 호스트 및 경로 규칙을 클릭합니다.
  2. 오른쪽 열에 images가 선택된 행이 있는지 확인합니다. 처음 두 열은 기본 규칙 Any unmatched (default)로 이미 채워져 있습니다.
  3. 계속하려면 창을 열어둡니다.

프런트엔드 추가

  1. 프런트엔드 구성을 클릭합니다.
  2. 이름example-forwarding-rule를 입력합니다.
  3. 프로토콜HTTPS를 선택합니다.
  4. 인증서 드롭다운 목록을 클릭합니다.
    1. 기본 SSL 인증서로 사용할 자체 관리형 SSL 인증서 리소스가 이미 있으면 드롭다운 메뉴에서 이 리소스를 선택합니다.
    2. 그 이외의 경우 새 인증서 만들기를 선택합니다.
    3. 인증서 업로드 또는 Google에서 관리하는 인증서 만들기를 선택합니다.
    4. 인증서 업로드를 선택한 경우 다음 단계를 완료합니다.
      1. example-ssl 이름을 입력합니다.
      2. 해당 필드에 공개키 인증서(.crt 파일), 인증서 체인(.csr 파일), 비공개 키(.key 파일)를 업로드합니다.
      3. 만들기를 클릭합니다.
    5. Google 관리 인증서 만들기를 선택한 경우 도메인에서 도메인을 입력한 후 만들기를 클릭합니다.
  5. 기본 SSL 인증서 리소스 외에 인증서 리소스를 추가하려면 다음 안내를 따르세요.
    1. 추가 인증서 > 인증서 추가를 클릭합니다.
    2. 인증서 목록에서 인증서를 선택하거나 새 인증서 만들기를 클릭하고 이전 안내를 따릅니다.
  6. 완료를 클릭합니다.
  7. 계속하려면 창을 열어둡니다.

검토 및 완료

  1. 검토 및 완료를 클릭합니다.
  2. 만들려던 설정과 현재 설정을 비교합니다.
  3. 모두 올바르게 표시되면 만들기를 클릭하여 외부 HTTP 부하 분산기를 만듭니다.

gcloud

  1. NEG의 새 백엔드 서비스를 만듭니다.

    gcloud compute backend-services create images \
       --global \
       --enable-cdn \
       --protocol=HTTP2
    
  2. 백엔드 서비스를 구성하여 커스텀 요청 헤더 Host: backend.example.com을 요청에 추가합니다.

    gcloud compute backend-services update images \
       --custom-request-header "Host: backend.example.com" --global
    
  3. backend-services add-backend 명령어를 사용하여 인터넷 NEG를 백엔드 서비스에 추가합니다.

    gcloud compute backend-services add-backend images \
      --network-endpoint-group "example-fqdn-neg" \
      --global-network-endpoint-group \
      --global
    
  4. 백엔드 서비스를 --default-service 값으로 지정하는 URL 맵을 만듭니다.

    gcloud compute url-maps create example-url-map \
       --default-service images \
       --global
    
  5. 인증서 리소스를 만듭니다.

    1. 자체 관리형 SSL 인증서 리소스를 만듭니다.

      gcloud compute ssl-certificates create example-ssl \
        --certificate CRT_FILE_PATH \
        --private-key KEY_FILE_PATH
      
    2. Google 관리 SSL 인증서 리소스를 만듭니다.

      gcloud beta compute ssl-certificates create example-ssl \
      --domains DOMAIN
      
  6. URL 맵과 SSL 인증서를 연결하여 새 대상 HTTPS 프록시를 만듭니다.

    gcloud compute target-https-proxies create example-target-https-proxy \
      --url-map=example-url-map \
      --ssl-certificates=example-ssl \
      --global
    
  7. 전역 애니캐스트 IP 주소를 구성하는 전역 전달 규칙을 만듭니다. 부하 분산기는 구성된 포트의 애니캐스트 IP 주소를 리슨합니다. 클라이언트는 Google Cloud 네트워크를 통해 백엔드에 연결할 수 있습니다.

    gcloud compute forwarding-rules create example-forwarding-rule \
       --ip-protocol=TCP \
       --ports=443 \
       --global \
       --target-https-proxy=example-target-https-proxy
    

테스트

전달 규칙의 IP 주소를 검색하고 브라우저나 명령줄 도구(예: curl)를 사용하여 IP 주소에 연결합니다.

gcloud compute forwarding-rules list

문제해결에 대한 도움말은 커스텀 원본 및 인터넷 NEG 문제해결을 참조하세요.

캐시 모드 사용

Cloud CDN이 Google Cloud 외부의 원본에서 콘텐츠를 가져오고 캐시하도록 구성한 경우 유효한 캐싱 헤더를 보내도록 애플리케이션이나 객체 스토리지 버킷을 업데이트하는 것이 어려울 수 있습니다.

이는 원본 서버에서 캐싱 헤더를 일관되지 않게 설정하거나, TTL을 너무 짧거나 길게 설정하거나,잘못된 캐시 지시문(예: 기존 애플리케이션에서)을 설정한 경우에도 적용됩니다.

다음을 수행하면 Cloud CDN이 이 원본의 모든 콘텐츠를 캐시하고 원본에서 설정한 TTL을 재정의하도록 구성할 수 있습니다.

  • 캐시 모드를 force-cache-all로 설정합니다.
  • 기본 TTL을 구성하여 원본의 모든 응답에 TTL을 적용합니다.

원본에서 정적 응답을 자동으로 캐시하려면 모든 정적 캐시 캐시 모드 설정(베타)을 사용하면 됩니다.

HTTP 캐시 지시문을 사용하여 각 응답의 캐시 가능성을 제어하려면 캐시 모드를 원본 헤더 사용으로 설정합니다. Cloud CDN에서 인식하는 캐시 지시문과 Cloud CDN에서 캐시되지 않는 캐시 지시문은 캐시 가능한 콘텐츠캐시할 수 없는 콘텐츠를 참조하세요.

원본이 사용자별 동적 콘텐츠를 제공하지 않는 경우 원본의 모든 응답을 캐시하려 할 수도 있습니다. 이렇게 하려면 force-cache-all 모드를 사용합니다. 이 모드는 콘텐츠 유형이나 캐시 지시문에 관계없이 모든 응답을 캐시합니다.

백엔드에서 Cloud CDN을 사용 설정할 때 캐시 모드를 명시적으로 선택하지 않으면 다음 기본값이 적용됩니다.

  • 베타 버전으로 출시되었습니다. Cloud CDN을 사용 설정하지만 캐시 모드를 지정하지 않는 경우 API 및 gcloud 기본값이 --use-origin-headers로 설정됩니다. 백엔드에서 Cloud CDN을 사용 설정하면 Cloud Console(지원되는 경우) 기본값은 --cache-all-static으로 설정됩니다.

  • 일반 안정화 버전. 모든 새로운 Cloud CDN 지원 백엔드 기본값은 구성 메서드(Cloud Console, API, gcloud)와 관계없이 --cache-all-static으로 설정됩니다.

다음 단계

  • Cloud CDN이 캐시에서 응답을 제공하고 있는지 확인하려면 로그 보기를 참조하세요.
  • 어떤 콘텐츠를 캐시하거나 캐시할 수 없는지 알아보려면 캐싱 개요를 참조하세요.
  • GFE 접속 지점을 찾으려면 캐시 위치를 참조하세요.