プラグインを管理する

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

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

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

プラグインを表示する

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

プラグインを一覧表示する

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

コンソール

  1. Google Cloud コンソールで、[Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

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

    • ステータス: プラグインのステータス。サービスが接続されていない場合、値は Not attached です。サービスにプラグインが接続されている場合、値は Attached です。
    • Name: プラグインの名前。
    • メイン バージョン: プラグインのアクティブなバージョン。
    • プロダクト: プラグインが関連付けられている Google Cloud プロダクト。
    • Type: 拡張機能のタイプ。
    • スコープ: プラグインのスコープ。
    • リージョン: プラグインのスコープが 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 コンソールで、[Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

  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 コンソールで、[Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

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

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

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

  4. 必要に応じて変更を加えます。

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

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

  5. [Update plugin] をクリックします。

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 コンソールで、[Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

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

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

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

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

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

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

  8. [Update plugin] をクリックします。

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 コンソールで、[Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

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

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

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

  5. [Update plugin] をクリックします。

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. [Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

  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 コンソールで、[Service Extensions] ページに移動します。

    Service Extensions に移動

  2. [Plugins] タブをクリックします。

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

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

  5. [Update plugin] をクリックします。

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 またはリージョン）

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

次のステップ