このページでは、Media CDN ルートに Service Extensions プラグインをデプロイする方法について説明します。
Service Extension で Media CDN を使用すると、リクエスト / レスポンス処理パスにカスタムコードを追加できます。このようなカスタマイズにより、さまざまな軽量のユースケースが実現します。
Service Extension のコンセプトの詳細については、Service Extensions の概要をご覧ください。
始める前に
Media CDN ルートに Service Extensions プラグインをデプロイする
Service Extensions プラグインを Media CDN ルートにデプロイするには、次の手順に沿って操作します。
サービスの現在の構成を YAML ファイルにエクスポートするには、
gcloud edge-cache services export
コマンドを実行します。gcloud edge-cache services export SERVICE_NAME \ --destination=FILENAME.yaml
次のように置き換えます。
SERVICE_NAME
: Media CDN サービスの名前FILENAME
: YAML ファイルの名前
Cloud Shell で、テキスト エディタを使用して YAML ファイルを編集します。
次の例に示すように、ファイル内のルートを更新して
wasmAction
ヘッダーを追加します。name: SERVICE_NAME routing: hostRules: - hosts: - DOMAIN_NAME pathMatcher: routes pathMatchers: - name: routes routeRules: - priority: '1' description: Route 1 matchRules: - prefixMatch: /plugins origin: projects/PROJECT_NUMBER/locations/global/edgeCacheOrigins/ORIGIN_NAME routeAction: wasmAction: projects/PROJECT_NUMBER/locations/global/wasmActions/WASM_ACTION
次のように置き換えます。
SERVICE_NAME
: Media CDN サービスの名前DOMAIN_NAME
: Media CDN サービスのドメインPROJECT_NUMBER
: プロジェクト番号ORIGIN_NAME
: コンテンツの送信元WASM_ACTION
: Service Extensions の WASM アクション
YAML ファイルを保存します。
gcloud edge-cache services import
コマンドを実行します。gcloud edge-cache services import SERVICE_NAME \ --source="FILENAME"
次のステップ
- Service Extension のコンセプトについて学習する。
- Service Extension を使用してプラグインを作成するために必要なファイルを準備してアップロードする方法を学習する。
- プラグインを作成する方法を学習する。