設定 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. 按一下「來源」Origins分頁標籤。

3. 按一下「Create origin」(建立來源)。

4. 輸入來源名稱，例如 cloud-storage-origin。

5. 選用：輸入來源說明。

6. 針對「Origin address」(來源位址)，選擇「Select a Google Cloud Storage bucket」(選取 Google Cloud Storage 值區)，再前往名為 my-bucket 的 Cloud Storage 值區，然後按一下「Select」(選取)。

   如果使用外部來源，請選擇「指定 FQDN 或 IP 位址」，然後輸入 FQDN 或 IP 位址。

7. 按一下「Create origin」(建立來源)。

大約 10 分鐘後，新建立的 EdgeCacheOrigin 資源會顯示在「來源」Origins頁面的專案來源清單中。

如要更新出發地址，請按一下出發地，然後點選「編輯」edit。

gcloud

使用 gcloud edge-cache origins create 指令：

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

更改下列內容：

• ORIGIN：新來源的名稱

• ADDRESS：bucket 名稱，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：bucket 名稱，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. 按一下 [Services] (服務) 標籤。

3. 按一下「Create service」(建立服務)。

4. 輸入服務的專屬名稱 (例如 my-service)，然後點選「Next」(下一步)。

5. 在「Routing」(轉送) 區段，按一下「Add host rule」(新增主機規則)，然後輸入一或多個主機網域名稱。

6. 在「Hosts」(主機) 區段，輸入主機網域名稱，例如 web.example.com。

7. 按一下「Add route rule」(新增轉送規則)。

   1. 在「Priority」(優先順序) 中指定 1。
   2. 按一下「Add match condition」(新增比對條件)，針對「Path match」(路徑比對) 指定 /，然後按一下「Done」(完成)。
   3. 選取「Fetch from an Origin」(從來源擷取)，然後選取您設定的來源。
   4. 按一下「Add-on actions」(外掛程式動作)。
   5. 在「Header action」(標頭動作) 部分，按一下「Add an item」(新增項目)。接著，按照下列步驟操作：
      1. 在「Type」(類型) 部分，選取「Response headers to add」(要新增的回應標頭)。
      2. 按一下「Add header」(新增標頭)。
      3. 將「Name」(名稱) 指定為 x-cache-status，並將「Value」(值) 指定為 {cdn_cache_status}。
      4. 按一下 [完成]。
   6. 在「Route action」(轉送動作) 部分，「Add an item」(新增項目)。接著，按照下列步驟操作：
      1. 在「Type」(類型) 部分，選取「CDN policy」(CDN 政策)。
      2. 在「Cache mode」(快取模式) 部分選取 FORCE_CACHE_ALL。
      3. 點選「Done」(完成)。
   7. 點選「Save」(儲存)。

8. 按一下「Create service」(建立服務)。

新建立的 EdgeCacheService 資源會顯示在專案的服務清單中，也就是「服務」頁面。

gcloud

1. 在 Cloud Shell 中，使用文字編輯器建立名為 my-service.yaml 的本機檔案。

   這類檔案表示：

   • 轉送運作方式：先比對主機，再比對路徑
   • 快取運作方式 - 根據快取模式和存留時間
   • 如何修改要求和回應，例如將 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 default route rule, priority=10 (low)"
        priority    = 10
        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. 按一下 [Services] (服務) 標籤。

3. 如要查看服務的 IP 位址，請參閱「Addresses」儲存格。

   如果儲存格空白，請重新整理瀏覽器。

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. 按一下 [Services] (服務) 標籤。

3. 選取服務，然後點選「Delete」(刪除)。

4. 按一下「來源」Origins分頁標籤。

5. 選取來源，然後點選「Delete」(刪除)。

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 替換為來源的簡短名稱。