Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Media CDN サービスを設定する

このクイックスタートでは、Cloud Storage バケットの前に Media CDN サービスを設定する方法について説明します。この構成は、テストで使用するか、本番環境のベースとして使用できます。

このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、「ガイドを表示」をクリックしてください。

ガイドを表示

このチュートリアルでは、次の手順について説明します。

コンテンツを保存する Cloud Storage バケットを作成します。
必要なサービスを有効にする。
Media CDN をバケットに接続する　EdgeCacheOrigin　送信元を作成する
EdgeCacheService リソースを作成して、送信元のコンテンツのリクエストルーティングとキャッシュを構成します。
レスポンスがキャッシュに保存されるかどうかをテストする。

始める前に

次の準備ができていることを確認します。

現在のプロジェクトの Media CDN へのアクセス権
Google Cloud CLI がインストールされている。バージョン 345.0.0 以降を使用してください。

必要に応じて、gcloud version を使用してバージョンを確認し、gcloud components update を使用してインストールされている gcloud CLI を更新します。

gcloud CLI には、gcloud edge-cache サブコマンドグループ新規および既存の Media CDN 構成を管理するための機能が用意されています。
Media CDN リソースの作成に必要な Identity and Access Management（IAM）権限。

必要なロール

このドキュメントのタスクを完了するために必要な権限を取得するには、管理者に次のロールの付与を依頼してください。

roles/networkservices.edgeCacheAdmin: すべての Edge Cache リソースの作成、更新、削除、管理を行うためのアクセス権。
roles/networkservices.edgeCacheUser: Edge Cache リソースを表示して使用するためのアクセス権。
roles/networkservices.edgeCacheViewer: Edge Cache リソースに対する読み取り専用アクセス権。

ストレージバケットを作成するには

ストレージ管理者ロール (roles/storage.admin)

Media CDN で SSL を有効にするには

Certificate Manager 編集者ロール (roles/certificatemanager.editor)

必要な権限は、カスタムロールや他の事前定義ロールを使用して取得することもできます。

Cloud Storage バケットを作成する

Media CDN コンテンツは、Cloud Storage バケット、サードパーティのストレージロケーション、ロードバランサなどのロケーションから配信できます。

このクイックスタートでは、Cloud Storage バケットにコンテンツを保存します。

一般公開されている Cloud Storage バケットを作成し、my-bucket という名前を付けます。

Cloud Storage バケットを一般公開しない場合は、Media CDN にバケットへのアクセス権を付与する必要があります。詳細については、非公開の Cloud Storage バケットを使用するをご覧ください。
ファイルをバケットにアップロードします。

必要なサービスを有効にする

Media CDN サービスを構成してデプロイするには、プロジェクトで両方の Network Services API と Certificate Manager API を有効にする必要があります。

Console

Network Services API を有効にします。

API の有効化
Certificate Manager API を有効にします

API の有効化

gcloud

Network Services API を有効にします。

gcloud services enable networkservices.googleapis.com

Certificate Manager API を有効にします。

gcloud services enable certificatemanager.googleapis.com

サービスの有効化と無効化の詳細については、 Service Usage のドキュメントをご覧ください。

`EdgeCacheOrigin` リソースを作成する

Cloud Storage バケットを指す送信元を作成します。

Console

コンソールで、[Media CDN] ページに移動します。 Google Cloud

Media CDN に移動
[送信元] タブをクリックします。
[オリジンを作成] をクリックします。
送信元の名前として「cloud-storage-origin」と入力します。
省略可: ルールの説明を入力します。
[元のアドレス] で、[Google Cloud Storage バケットを選択] を選択して my-bucket という名前の Cloud Storage バケットを参照し、[選択] をクリックします。

代わりに外部送信元がある場合は、[FQDN または IP アドレスを指定] を選択し、FQDN または IP アドレスを入力します。
[オリジンを作成] をクリックします。

約 10 分後、新しく作成した EdgeCacheOrigin リソースが [送信元] ページのプロジェクトの送信元リストに表示されます。

送信元アドレスを更新するには、送信元をクリックして [編集]をクリックします。

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

`EdgeCacheService` リソースを作成する

EdgeCacheService リソースは、ルーティング、証明書、キャッシュの設定を構成し、EdgeCacheOrigin リソースを指すことができます。

次の処理を行う基本的な EdgeCacheService リソースを作成します。

構成済みの送信元からのすべてのレスポンスを 1 時間キャッシュに保存する
キャッシュステータス（HIT、MISS など）を返す x-cache-status レスポンスヘッダーを設定する

必要に応じて、ドメイン名を登録しますこのサービスのために。

Console

コンソールで、[Media CDN] ページに移動します。 Google Cloud

Media CDN に移動
[Services] タブをクリックします。
[サービスを作成] をクリックします。
サービスの一意の名前（my-service など）を入力して、[次へ] をクリックします。
[**ルーティング**] セクションで、[**ホストルールを追加**] をクリックし、1 つ以上のホストドメイン名を入力します。
[ホスト] にホストのドメイン名（例: web.example.com）を入力します。
[ルートのルールを追加] をクリックします。
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. [保存] をクリックします。
[サービスを作成] をクリックします。

新しく作成した EdgeCacheService リソースが、プロジェクトのサービスリストの [Services] ページに表示されます。

gcloud

Cloud Shell で、テキストエディタを使用して my-service.yaml という名前のローカルファイルを作成します。

このようなファイルは、次のことを示します。
- ルーティングの仕組み - まずホストを照合し、次にパスを照合します。
- キャッシュの仕組み - キャッシュモードと TTL に基づきます。
- リクエストとレスポンスの変更方法（レスポンスヘッダーに cdn_cache_status 変数を挿入するなど）

次のサンプルコンテンツをファイルに貼り付けて保存します。

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: 関連する送信元の名前。

YAML ファイルで gcloud edge-cache services import コマンドを使用します。
```
gcloud edge-cache services import SERVICE \
    --source=my-service.yaml
```
プロジェクトの EdgeCacheService リソースのリストに新しく作成したサービスを表示するには、 gcloud edge-cache services list コマンドを使用します。

**注:** Media CDN がサービスを作成するまでに、最長で 10 分ほどかかることがあります。

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

最初のサービスが作成されるまでに数分かかることがあります。 Media CDN は専用の IP アドレスをプロビジョニングし、構成を数千のエッジロケーションにプッシュします。ルート構成や照合パラメータの変更など、サービスに対する後続の更新は高速です。

IP アドレスを取得する

新しく作成したサービスの IP アドレスを表示するには、次の操作を行います。

Console

コンソールで、[Media CDN] ページに移動します。 Google Cloud

Media CDN に移動
[Services] タブをクリックします。
サービスの 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

レスポンスがキャッシュに保存されているかどうかをテストする

サービスをテストする前に、Media CDN が取得できるように、送信元にキャッシュに保存可能なコンテンツが保存されていることを確認してください。

サービスがコンテンツをキャッシュするように正しく構成されていることをテストするには、curl コマンドラインツールを使用してリクエストを発行し、レスポンスを確認します。curl は、 Cloud Shell がインストールされたコンソールでも使用できます。 Google Cloud

ドメインで EdgeCacheService を使用する場合は、EdgeCacheService の IP アドレスをドメインレコードに割り当てることができます。手順については、Cloud DNS を使用してドメインを設定するをご覧ください。ドメインを設定したら、次の curl コマンドでコンテンツにアクセスします。

curl -svo /dev/null "http://DOMAIN_NAME/FILE_NAME"

プロビジョニングされた IP アドレスを指すように DNS を構成していない場合は、resolve オプションを使用して、curl が使用するアドレスをオーバーライドします。

curl -svo /dev/null --resolve DOMAIN_NAME:80:IP_ADDRESS "http://DOMAIN_NAME/FILE_NAME"

次のように置き換えます。

DOMAIN_NAME: サービスの作成時に指定したホストドメイン
IP_ADDRESS: サービスのリストの [アドレス] 列に表示されるサービスの IP アドレス
FILE_NAME: バケットにアップロードしたファイルの名前

例:

curl -svo /dev/null --resolve web.example.com:80:34.104.37.129 "http://web.example.com/file.mp4"

このコマンドを実行すると、最初は次のような出力が生成されます。ステータスは miss です。これは、Media CDN にはリクエストされた送信元から取得済みのデータがないためです。

< HTTP/2 200 OK
...
< x-cache-status: den;miss
...

同じリクエストを何度か送信すると、次のような出力が生成されます。ステータスは hit です。

< HTTP/2 200 OK
...
< x-cache-status: den;hit
...

ステータス hit が表示されない場合は、次の点を確認してください。

レスポンスがキャッシュに保存可能である。
構成されたキャッシュモードでコンテンツのキャッシュが許可されている。
送信元がキャッシュを防止するキャッシュディレクティブを設定していない。詳細については、キャッシュ構成をご覧ください。

これで、コンテンツをグローバルに配信できる基本的な EdgeCacheService リソースをテストしました。本番環境グレードのサービスには、SSL（TLS）証明書、複数の送信元、 Google Cloud Armor セキュリティポリシーが必要になる場合があります。

オプション: クリーンアップ

今後使用しないリソースを削除します。

Console

コンソールで、[Media CDN] ページに移動します。 Google Cloud

Media CDN に移動
[Services] タブをクリックします。
サービスを選択して [削除] をクリックします。
[送信元] タブをクリックします。
送信元を選択して [削除] をクリックします。

gcloud

作成したリソースを一覧表示するには、gcloud edge-cache origins list コマンドと gcloud edge-cache services list コマンドを使用します。
Pod を削除するには、gcloud edge-cache services delete コマンドを使用します。
```
gcloud edge-cache services delete SERVICE
```
SERVICE は、サービスの名前に置き換えます。
Pod を削除するには、gcloud edge-cache origins delete コマンドを使用します。
```
gcloud edge-cache origins delete ORIGIN
```
ORIGIN は、送信元の名前に置き換えます。

API

作成したリソースを一覧表示するには、edgeCacheServices.list メソッドと edgeCacheOrigins.list メソッドを使用します。
サービスを削除するには、 edgeCacheServices.delete メソッドを使用します。
```
DELETE https://networkservices.googleapis.com/v1/SERVICE_NAME
```
SERVICE_NAME は、サービス名に置き換えます。形式は次のようにします。
```
projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
```
SERVICE_ID は、サービスの略称に置き換えます。
Pod を削除するには、 edgeCacheOrigins.delete メソッドを使用します。
```
DELETE https://networkservices.googleapis.com/v1/ORIGIN
```
ORIGIN は、送信元の名前に置き換えます。形式は次のようにします。
```
projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
```
ORIGIN_ID は、送信元の略称に置き換えます。

作成した他のリソース（Cloud Storage バケットなど）で、今後使用しないリソースについても、このプロセスを繰り返します。

次のステップ

SSL（TLS）証明書を発行してアタッチする EdgeCacheServiceに。
リクエストログを表示する Cloud Logging で。
署名付きリクエストを構成してコンテンツを保護する。
キャッシュヒット率を向上させるためにキャッシュキーと TTL を最適化する
高度なルート照合を構成して、追加の送信元を作成する。

Media CDN サービスを設定する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なロール

Cloud Storage バケットを作成する

必要なサービスを有効にする

Console

gcloud

EdgeCacheOrigin リソースを作成する

Console

gcloud

API

Terraform

EdgeCacheService リソースを作成する

Console

gcloud

API

Terraform

IP アドレスを取得する

Console

gcloud

API

レスポンスがキャッシュに保存されているかどうかをテストする

オプション: クリーンアップ

Console

gcloud

API

次のステップ

Media CDN サービスを設定する

`EdgeCacheOrigin` リソースを作成する

`EdgeCacheService` リソースを作成する