プラグインを管理する

このページでは、Service Extensions を使用して作成されたプラグインを表示、編集、削除する方法について説明します。

プラグイン機能は、Media CDN のプレビュー版です。

プロダクトの概要については、Service Extensions の概要をご覧ください。

プラグインを表示する

このセクションでは、サービス拡張機能を使用して作成されたプラグインとプラグインのバージョンを表示する方法について説明します。

プラグインの一覧表示

プロジェクトのプラグインを一覧表示する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

    プラグインのリストが、次の情報を含む並べ替え可能な表に表示されます。

    • ステータス: プラグインのステータス。サービスが接続されていない場合、値は Not attached です。サービスがプラグインに関連付けられている場合、値は Attached です。
    • 名前: プラグインの名前。
    • メイン バージョン: プラグインのアクティブなバージョン。
    • プロダクト: プラグインが関連付けられている Google Cloud プロダクト。
    • タイプ: 拡張機能のタイプ。
    • スコープ: プラグインのスコープ。
    • Region: プラグイン スコープが Regional の場合のリージョン。
    • 使用中: プラグインが関連付けられている 1 つ以上の拡張機能。
    • 最終更新日: プラグインが最後に変更された日時。
    • ラベル: プラグインに追加されたラベル。

  3. 省略可: リストをフィルタするには、次の操作を行います。

    1. [表をフィルタ] の横をクリックして、プロパティのリストを表示します。

    2. リストからプロパティを選択します。

      プロパティ名とコロンが [フィルタ テーブル] ラベルの横に表示されます。

    3. コロンの横にスペースを挿入すると、プロパティに一致する値のリストが表示されます。リストから値を選択します。

    4. 省略可: プロパティと値のペアの間に OR 演算子を入力して、結合されたフィルタを指定します。

  4. 省略可: 選択したプラグインで他の操作を行うには、 [その他の操作] をクリックし、オプションを選択します。

gcloud

gcloud service-extensions wasm-plugins list コマンドを実行します。

gcloud service-extensions wasm-plugins list \
    --location=LOCATION

LOCATION は、プラグインのロケーション（global またはリージョン）に置き換えます。

プロジェクトのプラグインは、次の情報を含むテーブルにリストされます。

  • 名前: プラグインの名前
  • 説明: プラグインの説明
  • メイン バージョン: プラグインのアクティブなバージョン
  • 更新時間: プラグインが最後に変更された時刻

プラグインの詳細を表示する

プラグインの詳細を表示するには、次のいずれかの方法を使用します。

コンソール

  1. Google Cloud コンソールで、[サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

  3. 詳細を表示するプラグインの名前をクリックします。

    プラグインの [詳細] ページが開きます。このページには次のセクションがあります。

    • 基本情報: このセクションには、プラグインに関する基本情報が表示されます。たとえば、プラグインが関連付けられている Google Cloud プロダクト、ロードバランサのタイプ、拡張機能のタイプ、プラグインを使用している拡張機能、プラグインのスコープ、プラグインの作成と変更のタイムスタンプ、プラグインのサイズ、ラベル、ロギングが有効になっている場合はログのサンプリング レートと最小ロギングレベルなどです。

    • バージョン: このセクションには、プラグインのバージョン、作成タイムスタンプ、指定された説明、イメージの URI とダイジェスト、プラグイン構成ファイルまたはイメージと関連するダイジェストなど、プラグインのバージョンに関する詳細が表示されます。

      イメージの URL をクリックすると、その詳細が表示されます。

gcloud

プラグインの詳細を表示するには、gcloud service-extensions wasm-plugins describe コマンドを実行します。

 gcloud service-extensions wasm-plugins describe WASM_PLUGIN \
     --location=LOCATION

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

  • WASM_PLUGIN: プラグインの名前
  • LOCATION: プラグインのロケーション（global またはリージョン）

プラグインに関する次の詳細が表示されます。

  • プラグイン名
  • プラグインの作成と変更のタイムスタンプ
  • ラベル
  • ログのサンプリング レート（ロギングが有効になっている場合）

プラグインのバージョンを一覧表示するには、gcloud service-extensions wasm-plugin-versions list コマンドを使用します。

 gcloud service-extensions wasm-plugin-versions list WASM_PLUGIN \
     --location=LOCATION

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

  • WASM_PLUGIN: プラグインの名前
  • LOCATION: プラグインのロケーション（global またはリージョン）

指定したプラグインのバージョンが、プラグインの名前とともに表に表示されます。

プラグイン バージョンの詳細を表示するには、gcloud service-extensions wasm-plugin-versions describe コマンドを使用します。

 gcloud service-extensions wasm-plugin-versions describe WASM_PLUGIN_VERSION \
     --location=LOCATION

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

  • WASM_PLUGIN_VERSION: プラグインのメイン バージョン
  • LOCATION: プラグインのロケーション（global またはリージョン）

プラグインのバージョンに関する次の詳細が表示されます。

  • バージョン名
  • 作成のタイムスタンプ
  • 説明（入力されている場合）
  • イメージの URI とダイジェスト
  • プラグイン構成ファイルまたはイメージと関連するダイジェスト

プラグインを編集する

このセクションでは、Service Extensions を使用して作成したプラグインを編集する方法について説明します。

プラグインを編集する

プラグインを編集する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

  3. 編集するプラグインの [その他の操作] をクリックし、[編集] を選択します。

    または、プラグイン名をクリックし、[詳細] ページで 「編集」をクリックします。

    [プラグインを編集] ページでは、プラグインの名前は編集できません。他の詳細は編集できます。

  4. 必要に応じて変更します。

    ほとんどのフィールドについては、プラグインを作成するをご覧ください。

    [バージョン] セクションについては、プラグインの新しいバージョンを追加するをご覧ください。

  5. [プラグインを更新] をクリックします。

gcloud

gcloud service-extensions wasm-plugins update コマンドを実行します。

gcloud service-extensions wasm-plugins update WASM_PLUGIN \
   --location=LOCATION \
   --description=PLUGIN_DESCRIPTION \
   --labels=[LABELS,...]

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

  • WASM_PLUGIN: プラグインの名前
  • LOCATION: プラグインのロケーション（global またはリージョン）
  • PLUGIN_DESCRIPTION: プラグインの説明
  • LABELS: カンマ区切りの Key-Value ペア形式のラベル

プラグインの新しいバージョンを追加する

プラグイン コードの新しいバージョンを作成し、プラグインの新しいバージョンとして追加できます。

プラグインの新しいバージョンを追加する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

  3. [編集] をクリックします。

  4. [バージョン] セクションで、[バージョンを追加] をクリックします。

  5. [バージョンの追加] ペインで、プラグイン バージョンの詳細を指定します。

  6. 省略可: [メインに設定] チェックボックスをオンにします。

    このバージョンは後でメイン バージョンとして設定することもできます。

  7. [追加] をクリックします。

  8. [プラグインを更新] をクリックします。

gcloud

gcloud service-extensions wasm-plugins update コマンドを実行します。

 gcloud service-extensions wasm-plugins update WASM_PLUGIN \
     --location=LOCATION \
     --image=IMAGE \
     --main-version=MAIN_VERSION \
     --plugin-config=PLUGIN_CONFIG | --plugin-config-file=PLUGIN_CONFIG_FILE | --plugin-config-uri=PLUGIN_CONFIG_URI

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

  • WASM_PLUGIN: プラグインの ID または完全修飾名
  • LOCATION: プラグインのロケーション（global またはリージョン）
  • IMAGE: Artifact Registry リポジトリに保存されている新しい Wasm モジュールの URI
  • MAIN_VERSION: 作成してメイン（またはサービング）バージョンとして設定するプラグイン バージョンの ID。
  • PLUGIN_CONFIG、PLUGIN_CONFIG_FILE、PLUGIN_CONFIG_URI: 省略可能な構成ファイル。それぞれ、テキストとしてインラインで指定するか、ローカル ファイルとして指定するか、Artifact Registry のイメージとして指定できます。

プラグインのメイン バージョンを変更する

プラグインのメイン バージョンを変更する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

  3. [編集] ボタンをクリックします。

  4. [バージョン] セクションで、非アクティブなバージョンを選択し、[メインとして設定] をクリックします。

    または、プラグインの新しいバージョンを作成する際に、そのバージョンをメイン バージョンとして設定することもできます。

  5. [プラグインを更新] をクリックします。

gcloud

gcloud service-extensions wasm-plugins update コマンドを実行します。

 gcloud service-extensions wasm-plugins update \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

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

  • LOCATION: プラグインのロケーション（global またはリージョン）
  • WASM_PLUGIN_VERSION: プラグインのメイン バージョンの名前

新しいプラグイン バージョンがすべての場所に配信されるまでに数分かかることがあります。プラグインはすべての地域に同時に配信されるわけではないため、分数は地域によって異なる場合があります。

プラグインを削除する

このセクションでは、Service Extensions を使用して作成されたプラグインとプラグイン バージョンを削除する方法について説明します。

プラグインを削除する

プラグインを削除する手順は次のとおりです。

コンソール

  1. [サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

  3. 削除するプラグインの [その他の操作] ボタンをクリックし、[削除] を選択します。

    または、プラグイン名をクリックし、[詳細] ページの [削除] ボタンをクリックします。

    拡張機能で使用中のプラグインは削除できません。このようなプラグインを削除するには、まず拡張機能を変更してプラグインを削除するか、拡張機能を削除します。

  4. 確認メッセージ ボックスで、[削除] をクリックして操作を確定します。

gcloud

  1. サービス構成からプラグインへの参照を削除し、構成 YAML ファイルを再インポートします。

    詳細については、Cloud Load Balancing のルート プラグインとトラフィック プラグイン、Media CDN プラグインの構成方法をご覧ください。

  2. gcloud service-extensions wasm-plugins delete コマンドを実行します。

    gcloud service-extensions wasm-plugins delete WASM_PLUGIN \
    --location=LOCATION

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

    • WASM_PLUGIN: プラグインの名前
    • LOCATION: プラグインのロケーション（global またはリージョン）

プラグインを削除すると、関連するプラグイン リソースも削除されます。

プラグインのバージョンを削除する

プラグインのバージョンを削除する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[サービス拡張機能] ページに移動します。

    サービス拡張機能に移動

  2. [プラグイン] タブをクリックします。

  3. 編集するプラグインを選択し、編集モードに切り替えます。

  4. [バージョン] セクションで、削除するバージョンのチェックボックスをオンにして、[削除] をクリックします。

  5. [プラグインを更新] をクリックします。

gcloud

gcloud service-extensions wasm-plugin-versions delete コマンドを実行します。

 gcloud service-extensions wasm-plugin-versions delete WASM_PLUGIN_VERSION \
     --location=LOCATION

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

  • WASM_PLUGIN_VERSION: メイン バージョンとして使用されていないプラグイン バージョンの名前
  • LOCATION: プラグインのロケーション（global またはリージョン）

バージョンがメイン バージョン（アクティブなメイン バージョン）として設定されている場合は、別のバージョンをメイン バージョンとして設定した後にのみ削除できます。

次のステップ