Tutorial: Configurar o mecanismo de regras

Importante

O Azure Front Door (clássico) será desativado em 31 de março de 2027. Para evitar qualquer interrupção do serviço, é importante migrar seus perfis do Azure Front Door (clássico) para a camada Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, consulte Aposentadoria (clássica) do Azure Front Door.

Este tutorial mostra como criar uma configuração do mecanismo de regras e sua primeira regra no portal do Azure e na CLI.

Neste tutorial, irá aprender a:

  • Configure o mecanismo de regras usando o portal.
  • Configurar o mecanismo de regras usando a CLI do Azure

Pré-requisitos

Configurar mecanismo de regras no portal do Azure

  1. No recurso Front Door (clássico), selecione Configuração do mecanismo de regra em Configurações no painel de menu do lado esquerdo. Selecione + Adicionar, dê um nome à sua configuração e comece a criar sua primeira configuração do mecanismo de regras.

    Captura de tela da configuração do mecanismo de regras na página de visão geral do Front Door.

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

    Nota

    • Para excluir uma condição ou ação da regra, use a 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 parar de avaliar regras assim que a primeira condição de correspondência for atendida, marque Parar de avaliar a regra restante. Se isso for verificado e todas as condições de correspondência de uma regra específica forem atendidas, 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 dos cabeçalhos devem aderir ao RFC 7230.

    Captura de tela da página de configuração do mecanismo de regras com uma única regra.

  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 em primeiro lugar é a regra mais importante.

    Gorjeta

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

    Captura de ecrã da regra de cabeçalho da versão personalizada. Depois que as alterações forem atualizadas, você poderá acessar a URL para confirmar a versão da regra que está sendo invocada: Captura de tela da saída da versão do cabeçalho personalizado.

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

  5. Depois de criar uma configuração do mecanismo de regras, você pode associá-la a uma regra de roteamento. Uma única configuração pode ser aplicada 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, vá para o designer da porta frontal e selecione uma rota. Em seguida, selecione a configuração do mecanismo de regras a ser associada à regra de roteamento.

    Captura de tela do associado de configuração do mecanismo de regras da página de regra de roteamento.

Configurar o mecanismo de regras na CLI do Azure

  1. Instalar a CLI do Azure. Adicionar extensão "front-door":- az extension add --name front-door. Em seguida, inicie sessão e mude para a sua subscrição az account set --subscription <name_or_Id>.

  2. Comece criando um mecanismo de regras - este exemplo mostra uma regra com 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 # case sensitive word ‘rulesEngine’
    

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

Clean up resources (Limpar recursos)

Nas etapas anteriores, você configurou e associou a configuração do mecanismo de regras às suas regras de roteamento. Se você não quiser mais a configuração do mecanismo de regras associada à sua porta frontal (clássica), você pode remover a configuração executando as seguintes etapas:

  1. Desassocie todas as regras de roteamento da configuração do mecanismo de regras selecionando os três pontos ao lado do nome do mecanismo de regra e selecionando Associar regra de roteamento.

    Captura de tela das regras de roteamento associadas no menu.

  2. Desmarque todas as regras de roteamento às quais esta configuração do Mecanismo de Regras está associada e selecione Salvar.

    Associação de regra de roteamento

  3. Agora você pode excluir a configuração do mecanismo de regras da sua porta da frente.

    Excluir configuração do mecanismo de regra

Próximos passos

Neste tutorial, ficou a saber como:

  • Criar uma configuração do mecanismo de regra
  • Associe uma configuração a uma regra de roteamento.

Para saber como adicionar cabeçalhos de segurança com o mecanismo de regras, continue para o próximo tutorial.