Alibaba Cloud Service Mesh:テンプレートからの Envoy フィルター作成

前提条件

• ASM インスタンスにクラスターを追加済みであること。

• ASM インスタンスがバージョン 1.12.4.0 以降であること。ASM インスタンスのアップグレード手順については、「ASM インスタンスのアップグレード」をご参照ください。

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

Envoy フィルターテンプレートと Envoy フィルターは、抽象化とインスタンス化のペアを形成します。テンプレートは、実際に実行される Envoy フィルターを作成するために必要な構成とパラメーターを指定する設計図です。

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

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

Envoy フィルターにはバージョン互換性のリスクがあるため、独自に作成した Envoy フィルターは、メッシュのアップグレードとメンテナンスを大幅に困難にします。ASM 1.12.4.0 以降では、Envoy フィルターテンプレートを管理することで Envoy フィルターを作成できます。Service Mesh インスタンスがアップグレードされると、Envoy フィルターテンプレートは適合バージョンに基づいて、対応する Envoy フィルターを自動的に作成または変更します。これにより、Envoy フィルターのバージョン互換性リスクが制御され、使用のハードルが下がります。

バインドによってテンプレートがインスタンス化されます。ASM は、バインドする各ワークロードまたは名前空間に対して、対応する Envoy フィルターを自動的に作成します。そのため、1 つの Envoy フィルターテンプレートを複数のワークロードと名前空間にバインドし、そこから複数の Envoy フィルターを作成できます。

ステップ 1： Envoy フィルターテンプレートの作成

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

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

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

4. 複数バージョン対応 Envoy フィルターテンプレート セクションで、Envoy フィルターテンプレート対応バージョンの追加 をクリックし、Istio 対応バージョン を選択し、そのバージョンに適合する Envoy フィルターの内容を入力してから、作成 をクリックします。

   • ASM インスタンスがバージョン 1.18.0.146 以降の場合、下限なし セクションでは、メジャーバージョンの上限なし と Istio 対応バージョン がデフォルトで選択されています。Istio バージョン範囲をカスタマイズするには、下限なし または メジャーバージョンの上限なし のチェックを外してから、カスタムバージョンを入力します。

   • Envoy フィルターの構成例とフィールドの説明については、「」「Envoy Filter」をご参照ください。

   新しい Envoy フィルターテンプレートが Envoy フィルターテンプレート ページに表示されることを確認します。

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

Envoy フィルターテンプレートをワークロードまたは名前空間にバインドすることで、Envoy フィルターがそのワークロードまたは名前空間でのみ有効になります。開始する前に、次の 2 つの点を決定します。

• バインド範囲 — Envoy フィルターが単一のワークロードで有効になる必要がある場合は、ワークロードをバインドします。Envoy フィルターが名前空間全体で有効になる必要がある場合は、名前空間をバインドします。istio-system 名前空間をバインドすると、Envoy フィルターがグローバルに有効になります。

• ASM インスタンスバージョン — バインド用のコンソールのエントリポイントは、1.18.0.146 より前のインスタンスと 1.18.0.146 以降のインスタンスで異なります。ASM インスタンスのバージョンを確認してから、対応する手順に従ってください。

関連操作

以下の各操作は、Envoy フィルターテンプレート ページから開始します。バインドを変更する操作は、ASM インスタンスのバージョンによって異なるエントリポイントを使用します。

• 1.18.0.146 より前 — ワークロードのアタッチ ページの Envoy フィルターテンプレートの編集 タブ。

• 1.18.0.146 以降 — ワークロードのアタッチ ページの下部にある Envoy フィルターテンプレートの編集 セクション。