チュートリアル: ルール エンジンを構成する

適用対象: ✔️ Front Door (クラシック)

Important

Azure Front Door (クラシック) では、プロファイルの作成、新しいドメインオンボード、またはマネージド証明書はサポートされておらず、2027 年 31 月 31 日 で廃止されます。 サービスの中断を回避するには、Azure Front Door Standard または Premium に移行してください。 詳細については、「Azure Front Door (クラシック) の提供終了を参照してください。

このチュートリアルでは、Azure portal および CLI でルール エンジンの構成と最初のルールを作成する方法を説明します。

このチュートリアルでは、以下の内容を学習します。

  • ポータルを使用してルール エンジンを構成する。
  • Azure CLI を使用してルール エンジンを構成します。

Prerequisites

  • このチュートリアルの手順を実行する前に、まず、Azure Front Door (クラシック) を作成する必要があります。 詳細については、「Azure Front Door (クラシック) を作成する」を参照してください。

Azure ポータルでルール エンジンを構成する

  1. Azure Front Door (クラシック) リソースで、左側のメニューの Settings で Rule Engine configuration を選択します。 [ + 追加] を選択し、構成の名前を入力して、最初のルール エンジン構成の作成を開始します。

  2. 最初のルールの名前を入力します。 次に、[+ 条件の追加] または [+ アクションの追加] を選択してルールを定義します。

    Note

    • ルールから条件またはアクションを削除するには、特定の条件またはアクションの右側にあるごみ箱アイコンを使用します。
    • すべての受信トラフィックに適用されるルールを作成するには、条件を指定しないでください。
    • 最初の一致条件が満たされたときにルールの評価を停止するには、 [Stop evaluating remaining rule](残りのルールの評価を停止する) をオンにします。 この条件が満たされた場合、構成の残りのルールは実行されません。
    • ルール エンジン構成のすべてのパスで、大文字と小文字が区別されます。
    • ヘッダー名は RFC 7230 に準拠している必要があります。

  3. [上へ移動]、[下へ移動]、および [上へ移動] ボタンを使用して、構成内のルールの優先順位を決定します。 優先度は昇順です。つまり、最初に表示されるルールが最も重要なルールです。

    Tip

    変更が Azure Front Door (クラシック) に反映されるタイミングを確認する場合は、次の例を使用して、ルールにカスタム応答ヘッダーを作成できます。 応答ヘッダー _X-<RuleName>-Version_ を追加し、ルールが更新されるたびに値を変更できます。

    カスタム バージョン ヘッダー ルールのスクリーンショット。 変更が更新された後、URL に移動して、呼び出されるルールのバージョンを確認できます。カスタム ヘッダー バージョンの出力のスクリーンショット。

  4. 1 つ以上のルールを作成するときは、[ 保存] を選択します。 このアクションにより、ルール エンジンの構成が作成されます。

  5. ルール エンジンの構成を作成した後、構成をルーティング規則に関連付けます。 1 つの構成を複数のルーティング規則に適用できますが、ルーティング規則にはルール エンジンの構成を 1 つだけ設定できます。 構成を関連付けるには、[Azure Front Door（クラシック）デザイナー] に移動し、[ルート] を選択します。 次に、[ルール エンジンの構成] を選択して、ルーティング規則に関連付けます。

    ルーティング規則ページからの、ルール エンジンの構成の関連付けを示すスクリーンショット。

Azure CLI でルール エンジンを構成する

  1. Azure CLI をインストールし、"front-door" 拡張機能を追加します。

    az extension add --name front-door

    サインインして、お使いのサブスクリプションに切り替えます。

    az account set --subscription <name_or_Id>

  2. ヘッダーベースのアクションと一致条件を含む 1 つのルールがあるルール エンジンを作成します。

    az network front-door rules-engine rule create -f {front_door} -g {resource_group} --rules-engine-name {rules_engine} --name {rule1} --priority 1 --action-type RequestHeader --header-action Overwrite --header-name Rewrite --header-value True --match-variable RequestFilenameExtension --operator Contains --match-values jpg png --transforms Lowercase

  3. すべてのルールを一覧表示します。

    az network front-door rules-engine rule list -f {front_door} -g {rg} --name {rules_engine}

  4. 転送ルートのオーバーライド アクションを追加します。

    az network front-door rules-engine rule action add -f {front_door} -g {rg} --rules-engine-name {rules_engine} --name {rule1} --action-type ForwardRouteOverride --backend-pool {backend_pool_name} --caching Disabled

  5. ルール内のすべてのアクションを一覧表示します。

    az network front-door rules-engine rule action list -f {front_door} -g {rg} -r {rules_engine} --name {rule1}

  6. ルール エンジンの構成をルーティング規則にリンクします。

    az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --rules-engine {rules_engine}

  7. ルールエンジンのリンクを解除する。

    az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --remove rulesEngine

詳細については、Azure Front Door (クラシック) のルール エンジン コマンドの完全な一覧を参照してください。

リソースをクリーンアップする

Front Door (クラシック) からルール エンジン構成を削除するには:

  1. ルール エンジン名の横にある 3 つのドットを選択し、[ ルーティング規則の関連付け ] を選択して、規則エンジンの構成からルーティング規則の関連付けを解除します。

  2. このルール エンジンの構成に関連付けられているすべてのルーティング規則をオフにし、[保存] を選択 します。

  3. Front Door からルール エンジン構成を削除します。

    ルール エンジン構成を削除する

次のステップ

このチュートリアルでは、以下の内容を学習しました。

  • ルール エンジンの構成を作成する
  • 構成をルーティング規則に関連付ける

ルール エンジンを使用してセキュリティ ヘッダーを追加する方法については、次のチュートリアルに進んでください。

ルール エンジンを使用したセキュリティ ヘッダー

  • Last updated on