Alibaba Cloud Service Mesh:Envoy フィルターテンプレートを使用して Envoy フィルターを作成する

前提条件

v1.12.4.0 以降の ASM インスタンスにクラスターが追加されています。ASM インスタンスへのクラスターの追加方法の詳細については、「ASM インスタンスへのクラスターの追加」をご参照ください。ASM インスタンスの更新方法の詳細については、「ASM インスタンスの更新」をご参照ください。

Envoy フィルターテンプレートと Envoy フィルターの関係

Envoy フィルターは、Envoy フィルターテンプレートのインスタンスです。Envoy フィルターテンプレートは、Envoy フィルターの作成に必要な設定とパラメーターを指定する設計図または定義として機能します。

• Envoy フィルターテンプレート：Envoy フィルターの作成に必要なすべてのルールとパラメーターのテンプレートを含む事前定義された構成構造。テンプレートは、Envoy プロキシを通過するトラフィックの処理方法を定義しますが、トラフィックに直接適用されるわけではありません。

• Envoy フィルター：テンプレートを使用して作成される実際の構成エンティティ。Envoy フィルターは、ASM インスタンスの Envoy プロキシに適用され、プロキシを通過するトラフィックをフィルタリングおよび処理します。Envoy フィルターはテンプレートのインスタンスであり、テンプレート内のルールとパラメーターを実際のトラフィックに適用します。

自己管理型 Envoy フィルターは、インスタンスの更新またはメンテナンス後、ASM インスタンスと互換性がない場合があります。 v1.12.4.0 以降の ASM インスタンスでは、Envoy フィルターテンプレートを使用して Envoy フィルターを作成できます。ASM インスタンスを更新すると、システムは Envoy フィルターテンプレートを使用して新しい Envoy フィルターを自動的に作成するか、既存の Envoy フィルターを変更して、Envoy フィルターが ASM インスタンスと互換性があることを確認します。これにより、Envoy フィルターのバージョンの互換性の問題を防ぎ、Envoy フィルターを使いやすくします。

Envoy フィルターテンプレートを作成したら、Envoy フィルターテンプレートをワークロードまたは名前空間にバインドする必要があります。その後、ASM はテンプレートを使用して Envoy フィルターを自動的に作成します。 Envoy フィルターテンプレートは、複数のワークロードと名前空間にバインドできます。このようにして、テンプレートを使用して複数の Envoy フィルターを作成できます。

手順 1：Envoy フィルターテンプレートを作成する

1. ASM コンソール にログインします。左側のナビゲーションペインで、[サービスメッシュ] > [メッシュ管理] を選択します。

2. [メッシュ管理] ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションペインで、[プラグイン拡張センター] > [envoyfilter テンプレート] を選択します。表示されるページで、[envoyfilter テンプレートの作成] をクリックします。

3. [基本情報] セクションの [作成] ページで、Envoy フィルターテンプレートの名前を入力します。

4. [複数バージョンの Envoyfilter テンプレート] セクションで、[特定の Istio バージョンに適合した Envoyfilter テンプレートを追加] をクリックし、[適合 Istio バージョン] ドロップダウンリストから Istio バージョンを選択し、パラメーターを設定して、[作成] をクリックします。

   説明

   • ASM インスタンスのバージョンが 1.18.0.146 以降の場合、[最小バージョン制限なし] と [最大バージョン制限なし] は、[適合 Istio バージョン] セクションでデフォルトで選択されています。Envoy フィルターテンプレートが適用される Istio バージョンの範囲をカスタマイズするには、[最小バージョン制限なし] または [最大バージョン制限なし] をクリアして、バージョンを入力します。

   • Envoy フィルターの設定例とフィールドの詳細については、「Envoy Filter」をご参照ください。

   Envoy フィルターテンプレートを作成した後、[envoyfilter テンプレート] ページで Envoy フィルターテンプレートを表示できます。

手順 2：Envoy フィルターテンプレートをワークロードまたは名前空間にバインドする

Envoy フィルターテンプレートを作成したら、Envoy フィルターテンプレートをワークロードまたは名前空間にバインドする必要があります。このようにして、このテンプレートに基づいて作成された Envoy フィルターは、指定されたワークロードまたは名前空間にのみ有効になります。 Envoy フィルターテンプレートをワークロードまたは名前空間にバインドすると、ASM はテンプレートを使用して Envoy フィルターを自動的に作成します。 ASM インスタンスのバージョンに基づいて、次の操作を実行します。

関連操作

Envoy フィルターを変更する

[envoyfilter テンプレート] ページで、変更する Envoy フィルターテンプレートを見つけて、[テンプレートの編集] 列の [アクション] をクリックします。テンプレートパラメーターを変更し、[テンプレートの内容を変更] をクリックします。 Envoy フィルターテンプレートを変更すると、テンプレートを使用して作成された Envoy フィルターは自動的に更新されます。

Envoy フィルターを削除する

• ワークロードから Envoy フィルターテンプレートのバインドを解除して Envoy フィルターを削除する

  [envoyfilter テンプレート] ページで、構成する Envoy フィルターテンプレートを見つけて、[テンプレートの編集] 列の [アクション] をクリックします。 [テンプレートをワークロードにバインド] タブで、[envoyfilter をワークロードにバインド] をクリックします。 [envoyfilter をワークロードにバインド] ダイアログボックスで、[バインド済み] セクションでテンプレートのバインドを解除するワークロードの横にある [バインド解除] をクリックし、[OK] をクリックします。ワークロードから Envoy フィルターテンプレートのバインドを解除すると、テンプレートを使用してワークロード用に作成された Envoy フィルターは自動的に削除されます。

• 名前空間から Envoy フィルターテンプレートのバインドを解除して Envoy フィルターを削除する

  [envoyfilter テンプレート] ページで、構成する Envoy フィルターテンプレートを見つけて、[テンプレートの編集] 列の [アクション] をクリックします。 [テンプレートをワークロードにバインド] タブで、[envoyfilter を名前空間にバインド] をクリックします。 [envoyfilter を名前空間にバインド] ダイアログボックスで、[バインド済み] セクションでテンプレートのバインドを解除する名前空間をクリックし、[OK] をクリックします。名前空間から Envoy フィルターテンプレートのバインドを解除すると、テンプレートを使用して名前空間用に作成された Envoy フィルターは自動的に削除されます。

• Envoy フィルターテンプレートを削除して Envoy フィルターを削除する

  [envoyfilter テンプレート] ページで、削除する Envoy フィルターテンプレートを見つけて、[削除] 列の [アクション] をクリックします。表示されるメッセージで、[OK] をクリックします。 Envoy フィルターテンプレートを削除すると、テンプレートを使用して作成された Envoy フィルターは自動的に削除されます。