Tutorial: Configurar o mecanismo de regras

Aplica-se a: ✔️ Front Door (clássico)

Este tutorial mostra as etapas usadas para criar uma configuração do Mecanismo de regras e a sua primeira regra no portal do Azure e na CLI.

Neste tutorial, você aprenderá como:

Prerequisites

• Antes de poder concluir as etapas neste tutorial, é necessário criar primeiro um Azure Front Door (clássico). Para obter mais informações, confira Criar um Azure Front Door (clássico).

Configurar o Mecanismo de Regras no portal do Azure

1. No recurso Azure Front Door (clássico), selecione Configuração do Mecanismo de Regras em Configurações no menu à esquerda. Selecione + Adicionar, insira um nome para sua configuração e comece a criar sua primeira configuração do Mecanismo de Regras.

2. Insira um nome para a primeira regra. Em seguida, selecione + Adicionar condição ou + Adicionar ação para definir sua regra.

   Note

   • Para excluir uma condição ou ação da regra, use o ícone da lixeira no lado direito da condição ou ação específica.
   • Para criar uma regra que se aplique a todo o tráfego de entrada, não especifique nenhuma condição.
   • Para interromper a avaliação de regras depois que a primeira condição de correspondência for atendida, marque Interromper a avaliação da regra restante. Se essa condição for atendida, as regras restantes na configuração não serão executadas.
   • Todos os caminhos na configuração do mecanismo de regras diferenciam maiúsculas de minúsculas.
   • Os nomes de cabeçalho devem obedecer o RFC 7230.

3. Determine a prioridade das regras em sua configuração usando os botões Mover para cima, Mover para baixo e Mover para cima . A prioridade está em ordem crescente, o que significa que a regra listada primeiro é a mais importante.

   Tip

   Se você quiser verificar quando as alterações são propagadas para Azure Front Door (clássico), você pode criar um cabeçalho de resposta personalizado na regra usando o exemplo a seguir. É possível adicionar um cabeçalho de resposta _X-<RuleName>-Version_ e alterar o valor sempre que a regra for atualizada.

   Depois que as alterações forem atualizadas, acesse a URL para confirmar a versão da regra que está sendo invocada:

4. Ao criar uma ou mais regras, selecione Salvar. Essa ação cria a configuração do mecanismo de regras.

5. Depois de criar uma configuração do mecanismo de regras, associe a configuração a uma regra de roteamento. Você pode aplicar uma única configuração a várias regras de roteamento, mas uma regra de roteamento só pode ter uma configuração de mecanismo de regras. Para associar a configuração, acesse o designer do Azure Front Door (clássico) e selecione uma Rota. Em seguida, selecione a configuração do Mecanismo de regras a ser associada à regra de roteamento.

   

Configurar o mecanismo de regras na CLI do Azure

1. Instale a CLI do Azure e adicione a extensão "front-door":

   az extension add --name front-door
   

   Entre e alterne para sua assinatura:

   az account set --subscription <name_or_Id>
   

2. Crie um Mecanismo de Regras com uma regra, incluindo uma ação baseada em cabeçalho e uma condição de correspondência:

   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. Liste todas as regras:

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

4. Adicione uma ação de substituição de rota de encaminhamento:

   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. Liste todas as ações em uma regra:

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

6. Vincule uma configuração do mecanismo de regras a uma regra de roteamento:

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

7. Desvincule o mecanismo de regras:

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

Para obter mais informações, consulte a lista completa de comandos do Mecanismo de regras do Azure Front Door (clássico).

Limpar os recursos

Para remover a configuração do Mecanismo de Regras do Front Door (clássico):

1. Selecione os três pontos ao lado do nome do mecanismo de regra e selecione Associar regra de roteamento para desassociar todas as regras de roteamento da configuração do mecanismo de regra:

2. Desmarque todas as regras de roteamento associadas a essa configuração do Mecanismo de Regra e selecione Salvar:

3. Exclua a configuração do Mecanismo de Regra do Front Door:

   

Próximas etapas

Neste tutorial, você aprendeu a:

• Criar uma configuração do Mecanismo de regras
• Associar uma configuração a uma regra de roteamento

Para saber como adicionar cabeçalhos de segurança usando o mecanismo de regra, prossiga para o próximo tutorial.