Media CDN サービスを設定する

Console

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 リソースが、[Origins] ページのプロジェクトの送信元リストに表示されます。

送信元アドレスを更新するには、送信元をクリックして 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. [Services] タブをクリックします。

3. [サービスを作成] をクリックします。

4. サービスの一意の名前（例: my-service）を入力し、[次へ] をクリックします。

5. [ルーティング] セクションで、[ホストルールを追加] をクリックし、1 つ以上のホスト ドメイン名を入力します。

6. [ホスト] にホストのドメイン名（例: web.example.com）を入力します。

7. [ルートのルールを追加] をクリックします。

   1. [優先度] には 1 を指定します。
   2. [Add match condition] をクリックし、[パスの一致] に / を指定して [完了] をクリックします。
   3. [Origin から取得] を選択し、構成した送信元を選択します。
   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: 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 アドレスについては、[アドレス] セルをご覧ください。

   セルが空の場合は、ブラウザを更新します。

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. サービスを選択して [削除] をクリックします。

4. [送信元] タブをクリックします。

5. 送信元を選択して [削除] をクリックします。

gcloud

1. 作成したリソースを一覧表示するには、gcloud edge-cache origins list コマンドと gcloud edge-cache services list コマンドを使用します。

2. Pod を削除するには、gcloud edge-cache services delete コマンドを使用します。

   gcloud edge-cache services delete SERVICE
   

   SERVICE は、サービスの名前に置き換えます。

3. Pod を削除するには、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 は、オリジンの短縮名に置き換えます。