Delen via


Zelfstudie: Uw regelengine configureren

Belangrijk

Azure Front Door (klassiek) wordt op 31 maart 2027 buiten gebruik gesteld. Om serviceonderbrekingen te voorkomen, is het belangrijk dat u uw Azure Front Door-profielen (klassiek) tegen maart 2027 migreert naar de Azure Front Door Standard- of Premium-laag. Zie De buitengebruikstelling van Azure Front Door (klassiek) voor meer informatie.

Deze zelfstudie laat zien hoe u een regelengineconfiguratie en uw eerste regel maakt in zowel Azure Portal als CLI.

In deze zelfstudie leert u het volgende:

  • Regelengine configureren met behulp van de portal.
  • Regelengine configureren met behulp van Azure CLI

Vereisten

Regelengine configureren in Azure Portal

  1. Selecteer in uw Front Door-resource (klassiek) de configuratie van de regelengine onder Instellingen in het menuvenster aan de linkerkant. Selecteer + Toevoegen, geef uw configuratie een naam en begin met het maken van uw eerste regelengineconfiguratie.

    Schermopname van de configuratie van de regelengine op de overzichtspagina van Front Door.

  2. Voer een naam in voor uw eerste regel. Selecteer vervolgens + Voorwaarde toevoegen of + Actie toevoegen om uw regel te definiëren.

    Notitie

    • Als u een voorwaarde of actie wilt verwijderen uit een regel, gebruikt u het pictogram Prullenbak rechts van de voorwaarde of actie die u wilt verwijderen.
    • Als u een regel wilt maken die van toepassing is op alle binnenkomend verkeer, geeft u geen voorwaarden op.
    • Als u wilt stoppen met het evalueren van regels zodra aan de eerste voorwaarde is voldaan, selecteert u Stoppen met evalueren van resterende regels. Als deze optie is ingeschakeld en aan alle voorwaarden van een bepaalde regel wordt voldaan, worden de resterende regels in de configuratie niet uitgevoerd.
    • Alle paden in de configuratie van de regelengine zijn hoofdlettergevoelig.
    • Headernamen moeten voldoen aan RFC 7230.

    Schermopname van de configuratiepagina van de regelengine met één regel.

  3. Bepaal de prioriteit van de regels binnen uw configuratie met behulp van de knoppen Omhoog, Omlaag en Bovenaan. De prioriteit werkt in oplopende volgorde, wat betekent dat de regel die het eerst wordt vermeld, de belangrijkste regel is.

    Tip

    Als u wilt controleren wanneer de wijzigingen worden doorgegeven aan Azure Front Door, kunt u een aangepaste antwoordheader maken in de regel met behulp van het onderstaande voorbeeld. U kunt een antwoordheader _X-<RuleName>-Version_ toevoegen en de waarde wijzigen telkens wanneer de regel wordt bijgewerkt.

    Schermopname van de regel voor aangepaste versieheader. Nadat de wijzigingen zijn bijgewerkt, kunt u naar de URL gaan om te bevestigen dat de regelversie wordt aangeroepen: Schermopname van uitvoer van aangepaste headerversie.

  4. Nadat u een of meer regels hebt gemaakt, selecteert u Opslaan. Met deze actie maakt u de configuratie van de regelengine.

  5. Zodra u een regelengineconfiguratie hebt gemaakt, kunt u de configuratie koppelen aan een routeringsregel. Eén configuratie kan worden toegepast op meerdere routeringsregels, maar een routeringsregel kan slechts één regelengineconfiguratie hebben. Als u de configuratie wilt koppelen, gaat u naar de Ontwerpfunctie van Front Door en selecteert u een route. Selecteer vervolgens de configuratie van de regelengine die u wilt koppelen aan de routeringsregel.

    Schermopname van de configuratie van regelengines op de pagina routeringsregel.

Regelengine configureren in de Azure CLI

  1. Installeer Azure CLI. Voeg de extensie 'front-door' toe: -az extension add --name front-door. Meld u vervolgens aan en schakel over naar uw abonnement az account set --subscription <name_or_Id>.

  2. Begin met het maken van een regelengine. In dit voorbeeld maakt u één regel met één actie op basis van de header en één match-voorwaarde.

    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. Geef alle regels weer.

    az network front-door rules-engine rule list -f {front_door} -g {rg} --name {rules_engine}
    
  4. Voeg een actie toe voor het overschrijven van een doorstuurroute.

    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. Geef alle acties in een regel weer.

    az network front-door rules-engine rule action list -f {front_door} -g {rg} -r {rules_engine} --name {rule1}
    
  6. Koppel een configuratie van de regelengine aan een routeregel.

    az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --rules-engine {rules_engine}
    
  7. Koppel de regelengine los.

    az network front-door routing-rule update -g {rg} -f {front_door} -n {routing_rule_name} --remove rulesEngine # case sensitive word ‘rulesEngine’
    

Zie de volledige lijst met azure Front Door-regelengineopdrachten (klassiek) voor meer informatie.

Resources opschonen

In de voorgaande stappen hebt u de configuratie van de regelengine geconfigureerd en gekoppeld aan uw routeringsregels. Als u niet langer de configuratie van de regelengine wilt die is gekoppeld aan uw Front Door (klassiek), kunt u de configuratie verwijderen door de volgende stappen uit te voeren:

  1. Koppel eventuele routeringsregels los van de configuratie van de regelengine door de drie puntjes naast de naam van de regelengine te selecteren en routeringsregel koppelen te selecteren.

    Schermopname van de routeringsregels koppelen vanuit het menu.

  2. Schakel alle routeringsregels uit waaraan deze regelengineconfiguratie is gekoppeld en selecteer Opslaan.

    Koppeling voor routeringsregel

  3. U kunt nu de configuratie van de regelengine verwijderen van uw Front Door.

    Regelengine-configuratie verwijderen

Volgende stappen

In deze zelfstudie heeft u het volgende geleerd:

  • Een configuratie van een regelengine maken
  • Koppel een configuratie aan een routeringsregel.

Als u wilt weten hoe u beveiligingsheaders toevoegt met de regelengine, gaat u verder met de volgende zelfstudie.