設定 Media CDN 服務

本快速入門導覽課程說明如何在 Cloud Storage bucket 前方設定 Media CDN 服務。您可以將這項設定用於測試,或做為正式環境的基礎。


如要直接在 Google Cloud 控制台中,按照這項工作的逐步指南操作,請按一下「Guide me」(逐步引導)

逐步引導


本頁面將逐步說明下列程序:

  1. 建立 Cloud Storage bucket 來儲存內容。
  2. 啟用必要服務。
  3. 建立 EdgeCacheOrigin 資源,將 Media CDN 連結至 bucket。
  4. 建立 EdgeCacheService 資源,設定來源中內容的要求路徑和快取。
  5. 測試是否已快取回應。

事前準備

請確認您已具備以下條件:

必要的角色

如要取得完成本文件工作所需的權限,請要求管理員授予下列角色:

  • roles/networkservices.edgeCacheAdmin:可建立、更新、刪除及管理所有 Edge Cache 資源。
  • roles/networkservices.edgeCacheUser:可查看及使用 Edge Cache 資源。
  • roles/networkservices.edgeCacheViewer:Edge Cache 資源的唯讀存取權。

建立儲存空間 bucket

在 Media CDN 上啟用 SSL

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

建立 Cloud Storage bucket

Media CDN 內容可產生自 Cloud Storage bucket、第三方儲存空間位置或負載平衡器等位置。

在本快速入門導覽課程中,我們會將內容儲存在 Cloud Storage bucket 中。

  1. 建立可公開存取的 Cloud Storage bucket,並命名為 my-bucket

    如果您不想公開存取 Cloud Storage bucket,必須授予 Media CDN 存取 bucket 的權限。詳情請參閱「使用私人 Cloud Storage bucket」。

  2. 將檔案上傳至 bucket。

啟用必要服務

如要設定及部署 Media CDN 服務,必須在專案中啟用 Network Services APICertificate Manager API

控制台

  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
    

如要進一步瞭解如何啟用及停用服務,請參閱「服務使用情形說明文件」。

建立 EdgeCacheOrigin 資源

建立指向 Cloud Storage bucket 的來源。

控制台

  1. 前往 Google Cloud 控制台的「Media CDN」頁面。

    前往 Media CDN

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

  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 資源會顯示在「來源」頁面的專案來源清單中。

如要更新來源地址,請按一下來源,然後點選「編輯」

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}"
}

建立 EdgeCacheService 資源

EdgeCacheService 資源會設定路由、憑證和快取設定,並可指向 EdgeCacheOrigin 資源。

建立基本 EdgeCacheService 資源,執行下列操作:

  • 將設定來源的所有回應快取一小時
  • 設定 x-cache-status 回應標頭,傳回快取狀態 (例如 HITMISS)

(選用) 為這項服務註冊網域名稱

控制台

  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. 按一下「新增路由規則」

    1. 在「Priority」(優先順序) 中指定 1
    2. 按一下「Add match condition」(新增比對條件)