Media CDN 서비스 설정

콘솔

1. Network Services API를 사용 설정합니다.

   API 사용 설정

2. Certificate Manager API를 사용 설정합니다.

   API 사용 설정

gcloud

1. Network Services API를 사용 설정합니다.

   gcloud services enable networkservices.googleapis.com
   

2. Certificate Manager API를 사용 설정합니다.

   gcloud services enable certificatemanager.googleapis.com
   

콘솔

1. Google Cloud 콘솔에서 Media CDN 페이지로 이동합니다.

   Media CDN으로 이동

2. 원본 탭을 클릭합니다.

3. 원본 만들기를 클릭합니다.

4. 원본 이름을 cloud-storage-origin으로 입력합니다.

5. 원하는 경우 원본에 대한 설명을 입력합니다.

6. 원본 주소에서 Google Cloud Storage 버킷 선택을 선택하고 이름이 my-bucket인 Cloud Storage 버킷으로 이동한 후 선택을 클릭합니다.

   대신 외부 원본이 있으면 FQDN 또는 IP 주소 지정을 선택한 후 FQDN 또는 IP 주소를 입력합니다.

7. 원본 만들기를 클릭합니다.

약 10분 후 새로 생성된 EdgeCacheOrigin 리소스가 원본 페이지에서 프로젝트의 원본 목록에 표시됩니다.

원본 주소를 업데이트하려면 원본을 클릭한 후 edit수정을 클릭합니다.

gcloud

gcloud edge-cache origins create 명령어를 사용합니다.

gcloud edge-cache origins create ORIGIN \
    --origin-address="ADDRESS"

다음을 바꿉니다.

• ORIGIN: 새 원본의 이름

• ADDRESS: 버킷 이름 gs://my-bucket.

  대신 외부 원본이 있으면 ADDRESS를 FQDN 또는 IP 주소로 바꿉니다.

새로 만든 원본을 보려면 gcloud edge-cache origins list 명령어를 사용합니다.

원본 주소를 업데이트하려면 gcloud edge-cache origins update 명령어를 사용합니다.

API

edgeCacheOrigins.create 메서드를 사용합니다.

POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheOrigins?edgeCacheOriginId=ORIGIN_ID
{
  "name": "ORIGIN_ID",
  "originAddress: "ADDRESS"
}

다음을 바꿉니다.

• PARENT: projects/PROJECT/locations/global 형식의 상위 리소스
• ORIGIN_ID: 새 원본의 단축 이름

• ADDRESS: 버킷 이름 gs://my-bucket.

  대신 외부 원본이 있으면 ADDRESS를 FQDN 또는 IP 주소로 바꿉니다.

새로 만든 원본을 보려면 edgeCacheOrigins.list 메서드를 사용합니다.

원본 주소를 업데이트하려면 edgeCacheOrigins.patch 메서드를 사용합니다.

Terraform

resource "google_network_services_edge_cache_origin" "default" {
  name           = "cloud-storage-origin"
  origin_address = "gs://my-bucket-${random_id.unique_suffix.hex}"
}

콘솔

1. Google Cloud 콘솔에서 Media CDN 페이지로 이동합니다.

   Media CDN으로 이동

2. 서비스 탭을 클릭합니다.

3. 서비스 만들기를 클릭합니다.

4. 서비스의 고유한 이름(예: my-service)을 입력하고 다음을 클릭합니다.

5. 라우팅 섹션에서 호스트 규칙 추가를 클릭한 후 하나 이상의 호스트 도메인 이름을 입력합니다.

6. 호스트에 대해 호스트 도메인 이름을 입력합니다(예: web.example.com).

7. 라우팅 규칙 추가를 클릭합니다.

   1. 우선순위에 1을 지정합니다.
   2. 일치 조건 추가를 클릭하고 경로 일치에 대해 /를 지정한 후 완료를 클릭합니다.
   3. 원본에서 가져오기를 선택한 다음 자신이 구성한 원본을 선택합니다.
   4. 부가기능 작업을 클릭합니다.
   5. 헤더 작업에서 항목 추가를 클릭합니다. 다음 작업을 수행합니다.
      1. 유형에서 추가할 응답 헤더를 선택합니다.
      2. 헤더 추가를 클릭합니다.
      3. 이름에 x-cache-status를 지정하고 값에 {cdn_cache_status}를 지정합니다.
      4. 완료를 클릭합니다.
   6. 라우팅 작업에서 항목 추가를 클릭합니다. 다음 작업을 수행합니다.
      1. 유형에서 CDN 정책을 선택합니다.
      2. 캐시 모드로 FORCE_CACHE_ALL을 선택합니다.
      3. 완료를 클릭합니다.
   7. 저장을 클릭합니다.

8. 서비스 만들기를 클릭합니다.

새로 생성된 EdgeCacheService 리소스가 서비스 페이지에서 프로젝트의 서비스 목록에 표시됩니다.

gcloud

1. Cloud Shell에서 텍스트 편집기를 사용하여 my-service.yaml이라는 로컬 파일을 만듭니다.

   이러한 파일에는 다음이 표시됩니다.

   • 호스트 매칭을 먼저 수행하고 경로 매칭을 수행하는 라우팅 작동 방법
   • 캐시 모드와 TTL을 기반으로 하는 캐싱 작동 방법
   • 응답 헤더에 cdn_cache_status 변수 삽입 등을 통한 요청 및 응답 수정 방법

2. 다음 샘플 콘텐츠를 파일에 붙여넣고 저장합니다.

   name: SERVICE
   routing:
     hostRules:
     - hosts:
       - DOMAIN 
       pathMatcher: routes
     pathMatchers:
     - name: routes
       routeRules:
       - priority: 1
         matchRules:
         - prefixMatch: /
         origin: ORIGIN
         routeAction:
           cdnPolicy:
             cacheMode: CACHE_ALL_STATIC
             defaultTtl: 3600s
         headerAction:
           responseHeadersToAdd:
           - headerName: "x-cache-status"
             headerValue: "{cdn_cache_status}"
   

   다음을 바꿉니다.

   • SERVICE: 서비스의 이름
   • DOMAIN: 새 서비스의 도메인

   도메인 이름을 지정하면 Media CDN이 다른 호스트에 대해 404 오류로 응답합니다. * ORIGIN: 관련 원본의 이름입니다.

3. .yaml 파일에 gcloud edge-cache services import 명령어를 사용합니다.

   gcloud edge-cache services import SERVICE \
       --source=my-service.yaml
   

   프로젝트의 EdgeCacheService 리소스 목록에서 새로 생성된 서비스를 보려면 gcloud edge-cache services list 명령어를 사용합니다.

API

edgeCacheServices.create 메서드를 사용합니다.

POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheServices?edgeCacheServiceId=SERVICE_ID
{
  "name": "SERVICE_ID",
  "routing": {
    "hostRules": [
      {
        "hosts": ["DOMAIN"],
        "pathMatcher": "routes"
      }
    ],
    "pathMatchers": [
      {
        "name": "routes",
        "routeRules": [
          {
            "priority": "1",
            "matchRules": [
              {
                "prefixMatch": "/"
              }
            ],
            "origin": "ORIGIN",
            "routeAction": {
               "cdnPolicy": {
                 "cacheMode": "CACHE_ALL_STATIC",
                 "defaultTtl": "3600s"
               }
            }
            "headerAction": {
              "responseHeadersToAdd": [
                {
                  "headerName": "x-cache-status",
                  "headerValue": "{cdn_cache_status}"
                }
              ]
            },
          }
        ]
      }
    ]
  }
}

다음을 바꿉니다.

• PARENT: projects/PROJECT/locations/global 형식의 상위 리소스
• SERVICE_ID: 서비스의 이름

• DOMAIN: 새 서비스의 도메인

  도메인 이름을 지정하면 Media CDN이 다른 호스트에 대해 404 오류로 응답합니다.

• ORIGIN_NAME: 관련 원본의 이름

프로젝트의 EdgeCacheService 리소스 목록에서 새로 생성된 서비스를 보려면 edgeCacheServices.list 메서드를 사용합니다.

Terraform

resource "google_network_services_edge_cache_service" "default" {
  name = "cloud-media-service"
  routing {
    host_rule {
      hosts        = ["googlecloudexample.com"]
      path_matcher = "routes"
    }
    path_matcher {
      name = "routes"
      route_rule {
        description = "a route rule to match against"
        priority    = 1
        match_rule {
          prefix_match = "/"
        }
        origin = google_network_services_edge_cache_origin.default.name
        route_action {
          cdn_policy {
            cache_mode  = "CACHE_ALL_STATIC"
            default_ttl = "3600s"
          }
        }
        header_action {
          response_header_to_add {
            header_name  = "x-cache-status"
            header_value = "{cdn_cache_status}"
          }
        }
      }
    }
  }
}

콘솔

1. Google Cloud 콘솔에서 Media CDN 페이지로 이동합니다.

   Media CDN으로 이동

2. 서비스 탭을 클릭합니다.

3. 서비스의 IP 주소는 주소 셀을 참조하세요.

   셀이 비어 있으면 브라우저를 새로고침합니다.

gcloud

gcloud edge-cache services describe 명령어를 사용합니다.

gcloud edge-cache services describe SERVICE

SERVICE를 서비스 이름으로 바꿉니다.

출력에 서비스에 할당된 IP 주소가 표시됩니다.

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS
name: projects/my-project/locations/global/edgeCacheServices/SERVICE
...

API

edgeCacheServices.get 메서드를 사용합니다.

GET https://networkservices.googleapis.com/v1/SERVICE_NAME

SERVICE_NAME을 서비스의 전체 이름으로 바꿉니다. 다음 형식을 사용합니다.

projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID

SERVICE_ID를 서비스의 단축 이름으로 바꿉니다.

검색된 세부정보에는 서비스에 할당된 IP 주소가 포함됩니다.

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS

콘솔

1. Google Cloud 콘솔에서 Media CDN 페이지로 이동합니다.

   Media CDN으로 이동

2. 서비스 탭을 클릭합니다.

3. 서비스를 선택한 후 삭제를 클릭합니다.

4. 원본 탭을 클릭합니다.

5. 원본을 선택한 후 삭제를 클릭합니다.

gcloud

1. 만든 리소스를 나열하려면 gcloud edge-cache origins list 명령어 및 gcloud edge-cache services list 명령어를 사용합니다.

2. 서비스를 삭제하려면 gcloud edge-cache services delete 명령어를 사용합니다.

   gcloud edge-cache services delete SERVICE
   

   SERVICE를 서비스 이름으로 바꿉니다.

3. 원본을 삭제하려면 gcloud edge-cache origins delete 명령어를 사용합니다.

   gcloud edge-cache origins delete ORIGIN
   

   ORIGIN을 원본 이름으로 바꿉니다.

API

1. 만든 리소스를 나열하려면 edgeCacheServices.list 메서드 및 edgeCacheOrigins.list 메서드를 사용합니다.

2. 서비스를 삭제하려면 edgeCacheServices.delete 메서드를 사용합니다.

   DELETE https://networkservices.googleapis.com/v1/SERVICE_NAME
   

   SERVICE_NAME을 서비스의 전체 이름으로 바꿉니다. 다음 형식을 사용합니다.

   projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
   

   SERVICE_ID를 서비스의 단축 이름으로 바꿉니다.

3. 원본을 삭제하려면 edgeCacheOrigins.delete 메서드를 사용합니다.

   DELETE https://networkservices.googleapis.com/v1/ORIGIN
   

   ORIGIN을 원본의 전체 이름으로 바꿉니다. 다음 형식을 사용합니다.

   projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
   

   ORIGIN_ID를 원본의 단축 이름으로 바꿉니다.