サービスメッシュ（ASM）は、必要に応じて ASM 機能を拡張できるように、プラグインマーケットプレイスであらかじめ用意された機能を提供します。多様なニーズを満たすために、ビジネス要件に基づいてさまざまなプラグインを選択およびカスタマイズできます。
前提条件
バージョン 1.12.4.0 以降の ASM インスタンスが作成されていること。詳細については、「ASM インスタンスの作成」および「ASM インスタンスの更新」をご参照ください。
プラグインを有効にする
[ASM コンソール] にログインします。左側のナビゲーションペインで、 を選択します。
[メッシュ管理] ページで、ASM インスタンスの名前をクリックします。左側のナビゲーションペインで、 を選択します。
[マーケットプレイス] ページで、有効にするプラグインのカードをクリックします。
[プラグインの詳細] ページで、[プラグインユーザーガイド] タブをクリックして、プラグインの機能と YAML ファイルの構成方法の詳細を確認します。
[プラグインの詳細] ページで、[プラグインインスタンスの作成] をクリックし、次のパラメーターを構成してから、[プラグインスイッチ] をオンにします。
パラメーター
説明
名前
プラグインインスタンスの名前。
プラグインの有効範囲
プラグインが有効になる範囲。有効な値：
グローバル: プラグインは、Kubernetes クラスター内のすべてのイングレスゲートウェイとサイドカープロキシを含む、すべてのワークロードに有効になります。
ワークロードスコープ: プラグインは、指定されたワークロード、または指定された名前空間内のすべてのワークロードに有効になります。
ゲートウェイスコープ: プラグインは、指定されたイングレスゲートウェイに有効になります。
有効範囲にワークロードを追加
このパラメーターは、[プラグインの有効範囲] パラメーターが [ワークロードスコープ] に設定されている場合にのみ構成できます。
[有効範囲にワークロードを追加] をクリックします。[有効範囲にワークロードを追加] ダイアログボックスで、追加するワークロードが存在する名前空間を選択し、ワークロードタイプを選択し、左側の [ワークロードの選択] セクションで追加するワークロードを選択し、右側の [選択済み] セクションにワークロードを追加して、[OK] をクリックします。ワークロードタイプは、サービスまたはデプロイメントです。
[プラグインの詳細] ページの [有効範囲内のサイドカー] セクションで、有効範囲に追加されたワークロードを表示できます。
有効範囲に名前空間を追加
このパラメーターは、[プラグインの有効範囲] パラメーターが [ワークロードスコープ] に設定されている場合にのみ構成できます。
[有効範囲に名前空間を追加] をクリックします。[有効範囲に名前空間を追加] ダイアログボックスで、[有効範囲にない名前空間] セクションで、追加する名前空間のタグをクリックします。名前空間のタグは、[有効範囲内の名前空間] セクションに自動的に移動されます。次に、[OK] をクリックします。
[プラグインの詳細] ページの [有効範囲内のサイドカー] セクションで、有効範囲に追加された名前空間を表示できます。
有効範囲に ASM ゲートウェイを追加
このパラメーターは、[プラグインの有効範囲] が [ゲートウェイスコープ] に設定されている場合にのみ構成できます。
[有効範囲に ASM ゲートウェイを追加] をクリックします。[有効範囲に ASM ゲートウェイを追加] ダイアログボックスで、左側の [ASM ゲートウェイの選択] セクションで追加するゲートウェイをクリックし、右側の [選択済み] セクションにゲートウェイを追加して、[OK] をクリックします。
[プラグインの詳細] ページの [有効範囲内の ASM ゲートウェイ] セクションで、有効範囲に追加されたゲートウェイを表示できます。
プラグイン設定
ビジネス要件に基づいて、YAML コードエディターでいくつかのパラメーターを指定する必要があります。これらのパラメーターの詳細については、[プラグインユーザーガイド] タブを参照してください。
プラグインスイッチ
[プラグインスイッチ] をオンにした後でのみ、プラグイン設定が有効になります。
関連操作
プラグインが有効になったら、[プラグインの詳細] ページの目的のプラグインインスタンスを構成するためのタブで、次の操作を実行できます。
操作 | 手順 |
プラグインの有効範囲を変更する | [プラグインの有効範囲] セクションで、プラグインが有効になる範囲をクリックします。[プラグインの有効範囲の変更] メッセージで、[OK] をクリックします。 |
有効範囲にワークロードを追加する | このパラメーターは、[プラグインの有効範囲] パラメーターが [ワークロードスコープ] に設定されている場合にのみ構成できます。 [有効範囲にワークロードを追加] をクリックします。[有効範囲にワークロードを追加] ダイアログボックスで、追加するワークロードが存在する名前空間を選択し、ワークロードタイプを選択し、左側の [ワークロードの選択] セクションで追加するワークロードを選択し、右側の [選択済み] セクションにワークロードを追加して、[OK] をクリックします。ワークロードタイプは、サービスまたはデプロイメントです。 [有効範囲内のサイドカー] セクションの [プラグインの詳細] ページで、有効範囲に追加されたワークロードを表示できます。 |
有効範囲に名前空間を追加する | このパラメーターは、[プラグインの有効範囲] パラメーターが [ワークロードスコープ] に設定されている場合にのみ構成できます。 [有効範囲に名前空間を追加] をクリックします。[有効範囲に名前空間を追加] ダイアログボックスで、[有効範囲にない名前空間] セクションで、追加する名前空間のタグをクリックします。名前空間のタグは、[有効範囲内の名前空間] セクションに自動的に移動されます。次に、[OK] をクリックします。 [有効範囲内のサイドカー] セクションの [プラグインの詳細] ページで、有効範囲に追加された名前空間を表示できます。 |
有効範囲にゲートウェイを追加する | このパラメーターは、[プラグインの有効範囲] が [ゲートウェイスコープ] に設定されている場合にのみ構成できます。 [有効範囲に ASM ゲートウェイを追加] をクリックします。[有効範囲に ASM ゲートウェイを追加] ダイアログボックスで、左側の [ASM ゲートウェイの選択] セクションで追加するゲートウェイをクリックし、右側の [選択済み] セクションにゲートウェイを追加して、[OK] をクリックします。 [有効範囲内の ASM ゲートウェイ] セクションの [プラグインの詳細] ページで、有効範囲に追加されたゲートウェイを表示できます。 |
プラグイン設定 YAML ファイルを編集する | [プラグイン設定] セクションで、[更新] をクリックし、YAML ファイルを編集して、[YAML] コードエディターの右上隅にある [保存] をクリックします。新しい設定はすぐに有効になります。 |
有効範囲からワークロードを削除する | [有効範囲内のサイドカー] セクションで、削除するワークロードを見つけ、[アクション] 列の [バインド解除] をクリックします。[有効範囲の削除] メッセージで、[OK] をクリックします。 |
有効範囲からゲートウェイを削除する | [有効範囲内の ASM ゲートウェイ] セクションで、削除するゲートウェイのタグにある |
プラグインを無効にする | 目的のプラグインインスタンスを構成するためのタブの右側にある 重要 プラグインを無効にすると、システムの安定性またはビジネスロジックに影響が及ぼされ、予期しない問題が発生する可能性があります。この操作を実行する際は注意してください。 |
アイコンをクリックします。[有効範囲の削除] メッセージで、[OK] をクリックします。
アイコンをクリックします。[プラグインインスタンスの削除] メッセージで、[OK] をクリックします。参考資料
Web アプリケーションの HTTP レスポンスヘッダーを追加して、アプリケーションのセキュリティを向上させることができます。詳細については、「ASM で Envoy フィルターを使用して HTTP レスポンスヘッダーを追加する」をご参照ください。
ASM 内のアプリケーション間で双方向のリアルタイム通信を実装する必要がある場合は、AllowConnect プラグインを有効にして、HTTP/2 経由の WebSocket トンネル接続をサポートできます。詳細については、「ASM で WebSocket 接続を介してサービスにアクセスする」をご参照ください。
Spring Cloud サービスを ASM に接続できます。このようにして、アプリケーションコードを変更することなく、クラウドネイティブのサービスガバナンス機能を使用して Spring Cloud サービスを管理できます。詳細については、「Spring Cloud サービスの管理」をご参照ください。