Tutorial: Konfigurieren Ihres Regelmoduls

Artikel
11/20/2024

In diesem Tutorial wird erläutert, wie Sie eine Regelmodulkonfiguration und Ihre erste Regel sowohl im Azure-Portal als auch über die Befehlszeilenschnittstelle erstellen.

In diesem Tutorial lernen Sie Folgendes:

Konfigurieren des Regelmoduls über das Portal
Konfigurieren des Regelmoduls mithilfe der Azure CLI.

Voraussetzungen

Um die Schritte in diesem Tutorial auszuführen, müssen Sie zunächst Azure Front Door (klassisch) erstellen. Weitere Informationen finden Sie unter Erstellen von Azure Front Door (klassisch).

Konfigurieren des Regelmoduls im Azure-Portal

Wählen Sie in Ihrer Azure Front Door-Ressource (klassisch) unter Einstellungen im linken Menübereich die Option Regelmodulkonfiguration aus. Klicken Sie auf + Hinzufügen, geben Sie Ihrer Konfiguration einen Namen, und beginnen Sie mit dem Erstellen Ihrer ersten Regelmodulkonfiguration.
Geben Sie einen Namen für Ihre erste Regel ein. Klicken Sie dann auf + Bedingung hinzufügen oder + Aktion hinzufügen, um die Regel zu definieren.
Hinweis
- Zum Löschen einer Bedingung oder Aktion aus einer Regel verwenden Sie das Papierkorbsymbol auf der rechten Seite der jeweiligen Bedingung oder Aktion.
- Geben Sie keine Bedingungen an, um eine Regel zu erstellen, die für den gesamten eingehenden Datenverkehr gilt.
- Um die Auswertung von Regeln zu unterbinden, sobald die erste Übereinstimmungsbedingung erfüllt ist, aktivieren Sie Auswertung der verbleibenden Regeln beenden. Wenn diese Option aktiviert ist und alle Übereinstimmungsbedingungen einer bestimmten Regel erfüllt sind, werden die verbleibenden Regeln in der Konfiguration nicht ausgeführt.
- Bei allen Pfaden in der Konfiguration des Regelmoduls wird die Groß-/Kleinschreibung beachtet.
- Headernamen sollten RFC 7230entsprechen.
Bestimmen Sie die Priorität der Regeln in der Konfiguration, indem Sie die Schaltflächen zum Verschieben nach oben, nach unten und ganz nach oben verwenden. Die Priorität ist in aufsteigender Reihenfolge, was bedeutet, dass die erste aufgelistete Regel die wichtigste Regel ist.

Tipp

Wenn Sie überprüfen möchten, ob die Änderungen an Azure Front Door (klassisch) weitergegeben werden, können Sie mithilfe des folgenden Beispiels einen benutzerdefinierten Antwortheader in der Regel erstellen. Sie können einen Antwortheader (_X-<RuleName>-Version_) hinzufügen und den Wert bei jeder Aktualisierung der Regel ändern.

Nach dem Anwenden der Änderungen können Sie zur URL wechseln, um die aufgerufene Regelversion zu überprüfen:
Nachdem Sie eine oder mehrere Regeln erstellt haben, klicken Sie auf Speichern. Mit dieser Aktion wird die Konfiguration des Regelmoduls erstellt.
Nachdem Sie eine Regelmodulkonfiguration erstellt haben, können Sie die Konfiguration einer Routingregel zuordnen. Eine einzelne Konfiguration kann auf mehrere Routingregeln angewendet werden, aber eine Routingregel kann nur eine Regelmodulkonfiguration aufweisen. Um die Konfiguration zuzuordnen, wechseln Sie zum Azure Front Door-Designer (klassisch), und wählen Sie eine Route aus. Wählen Sie dann die Regelmodulkonfiguration aus, die der Routingregel zugeordnet werden soll.

Konfigurieren des Regelmoduls in der Azure CLI

Installieren Sie die Azure CLI und fügen Sie die „front-door”-Erweiterung hinzu:
```
az extension add --name front-door
```
Melden Sie sich an, und wechseln Sie zu Ihrem Abonnement:
```
az account set --subscription <name_or_Id>
```

Erstellen Sie ein Regelmodul mit einer Regel, einschließlich einer headerbasierten Aktion und einer Übereinstimmungsbedingung:

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

Listen Sie alle Regeln auf:

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

Fügen Sie eine Aktion zur Außerkraftsetzung der Weiterleitungsroute hinzu:

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

Listen Sie alle Aktionen in einer Regel auf:

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

Verknüpfen Sie eine Regelmodulkonfiguration mit einer Routingregel:

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

Heben Sie die Verknüpfung des Regelmoduls auf:

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

Weitere Informationen finden Sie in der vollständigen Liste der Regelmodulbefehle für Azure Front Door (klassisch).

Bereinigen von Ressourcen

So entfernen Sie die Regelmodulkonfiguration aus Front Door (klassisch):

Trennen Sie alle Routingregeln von der Regelmodulkonfiguration, indem Sie die drei Punkte neben dem Namen des Regelmoduls auswählen und Routingregel zuordnen auswählen:
Deaktivieren Sie alle Routingregeln, die dieser Regelmodulkonfiguration zugeordnet sind, und klicken Sie auf Speichern:
Löschen Sie die Regelmodulkonfiguration aus Front Door: