--- name: azion-roteie-requisicoes-por-pais-ou-continente description: >- Envie as requisições de um continente ou de uma lista de países ao seu próprio connector com uma regra de geolocalização depois da regra padrão. --- # Roteie requisições por país ou continente Você envia as requisições de um continente, ou de uma lista de países, a um connector regional com uma regra de geolocalização, pelo Azion Console, pela API ou pela Azion CLI. Para dar a um connector uma origem de backup que recebe as requisições quando a sua origem primária falha, consulte [Adicione uma origem de backup a um connector](/pt-br/documentacao/guias/performance-e-confiabilidade/disponibilidade/adicionar-uma-origem-de-backup-a-um-connector/). Uma regra de geolocalização lê a localização do endereço IP do cliente na Request Phase e nomeia um connector com *Set Connector*. *Set Connector* não se acumula entre regras: quando várias regras que correspondem o carregam, somente o da última regra que corresponde é executado. Uma regra padrão que envia todos os caminhos a um connector vem, portanto, primeiro, e cada regra de geolocalização vem depois dela e substitui o padrão para as requisições a que corresponde. ```mermaid %%{init: {"layout": "dagre", "themeVariables": {"fontSize": "13px"}, "flowchart": {"nodeSpacing": 12, "rankSpacing": 12, "padding": 6, "wrappingWidth": 70, "minNodeWidth": 40, "useMaxWidth": true}}}%% flowchart TD Req["Uma requisição chega à aplicação"] --> R1["Regra 1: todos os caminhos, Set Connector origin-default"] R1 --> R2{"Regra 2: o continente ou o país corresponde?"} R2 -->|"sim: a última correspondência vence"| Reg["origin-regional"] R2 -->|"não"| Def["origin-default permanece"] ``` 1. Toda requisição corresponde à primeira regra, que define `origin-default`. 2. Uma requisição do continente ou dos países da segunda regra também corresponde a ela, que define `origin-regional`, e a regra posterior vence. 3. Qualquer outra requisição mantém `origin-default`. --- ## Pré-requisitos - Uma aplicação servida por um workload, com uma primeira regra cujo behavior *Set Connector* envia todas as requisições, `${uri}` *starts with* `/`, ao connector padrão. Para criá-los, consulte [Primeiros passos com Applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/). - Um segundo connector, para a região. Para criar um, consulte [Primeiros passos com Connectors](/pt-br/documentacao/plataforma/connectors/primeiros-passos/). - Um [personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/), para os procedimentos pela API. - A [Azion CLI](/pt-br/documentacao/devtools/cli/) instalada e autorizada, para os procedimentos pela CLI. Os exemplos usam `origin-default` para o connector padrão, `origin-regional` com o ID `` para o regional e a aplicação ``. Substitua-os pelos seus valores. --- ## Crie a regra de geolocalização O critério nomeia a localização a corresponder. O Rules Engine a lê do endereço IP do cliente, e as variáveis e os operadores abaixo não exigem nenhum Produto na aplicação: | Para corresponder a | Variável | Operador | Argumento | | ------------------- | ---------------------------------------------------------------- | ---------------------- | ----------------------------------------------------------- | | Um continente | `${geoip_continent_code}`, o código de continente de duas letras | *is equal*, `is_equal` | Um código como `NA`, para a América do Norte | | Um país | `${geoip_country_code}`, o código de país de duas letras | *is equal*, `is_equal` | Um código como `RU`, para a Rússia | | Uma lista de países | `${geoip_country_code}` | *matches*, `matches` | Uma expressão regular de códigos de país, como `^(BR\|AR)$` | Um código de continente é geografia, não uma jurisdição. Quando uma regra deve seguir os países que uma lei ou um contrato nomeia, corresponda à lista de países. As variáveis `${geoip_city_*}` leem outra base de geolocalização, `geoip_city`. Para todas as variáveis de geolocalização, consulte [Variáveis](/pt-br/documentacao/plataforma/applications/rules-engine/#variaveis). Os procedimentos correspondem ao continente `NA`. Para uma lista de países, troque o critério pelo da tabela. **Console** Para criar a regra no Azion Console: 1. **Vá para a aba Rules Engine** Acesse [Azion Console](https://console.azion.com/) > **Applications** > **sua aplicação** e vá para a aba **Rules Engine**. 2. **Selecione + Rule** 3. **Nomeie a regra** Insira um nome que identifique a região. Por exemplo: `geo - north america`. 4. **Selecione Request Phase** 5. **Corresponda ao continente** Na seção **Criteria**, defina o critério como `${geoip_continent_code}` *is equal* `NA`. 6. **Defina o connector** Na seção **Behaviors**, selecione **Set Connector** e, em seguida, selecione `origin-regional`. 7. **Selecione Save** A regra aparece na lista **Request** da aba **Rules Engine**. **API** Os critérios carregam `${geoip_continent_code}`, que um shell expande, então o corpo é enviado de um arquivo. Para criar a regra: 1. **Escreva a regra em um arquivo** Salve o conteúdo a seguir como `rule.json`, com o ID de `origin-regional` em `attributes.value`: ```json { "name": "geo - north america", "active": true, "criteria": [[{ "variable": "${geoip_continent_code}", "conditional": "if", "operator": "is_equal", "argument": "NA" }]], "behaviors": [{ "type": "set_connector", "attributes": { "value": } }] } ``` 2. **Envie a requisição de criação** ```bash curl --request POST \ --url https://api.azion.com/v4/workspace/applications//request_rules \ --header 'Accept: application/json' \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data @rule.json ``` A API responde `202` com `"state": "pending"` e a regra como foi armazenada, com o seu `id` e a sua `order` na fase. **CLI** A CLI lê a regra de um arquivo JSON. Para criar a regra: 1. **Escreva a regra em um arquivo** Salve o conteúdo a seguir como `rule.json`, com o ID de `origin-regional` em `attributes.value`: ```json { "name": "geo - north america", "active": true, "criteria": [[{ "variable": "${geoip_continent_code}", "conditional": "if", "operator": "is_equal", "argument": "NA" }]], "behaviors": [{ "type": "set_connector", "attributes": { "value": } }] } ``` 2. **Crie a regra** ```bash azion create rules-engine --application-id --phase request --file rule.json ``` O comando imprime o ID da regra: ```text Created Rules Engine with ID ``` As requisições da América do Norte vão para `origin-regional` quando a regra se propaga, e todas as outras requisições mantêm `origin-default`. Uma regra nova leva alguns minutos para chegar a todos os data centers. --- ## Mantenha a regra de geolocalização depois da regra padrão A plataforma cria uma regra nova no fim da sua fase, que é a posição de que uma regra de geolocalização precisa. Uma lista reordenada pode deixar a regra padrão por último, e ela então envia de novo todas as requisições a `origin-default`, sem mudança em nenhuma regra. Verifique a ordem depois de cada mudança na lista. **Console** Para verificar a ordem no Azion Console: 1. **Vá para a aba Rules Engine** Acesse [Azion Console](https://console.azion.com/) > **Applications** > **sua aplicação** e vá para a aba **Rules Engine**. 2. **Encontre a regra de geolocalização na lista Request** `geo - north america` fica depois da regra padrão. Se não ficar, mova-a para baixo da regra padrão. **API** Para definir a ordem, envie os IDs das regras da fase na nova ordem, a regra padrão primeiro, no array `order`: ```bash curl --request PUT \ --url https://api.azion.com/v4/workspace/applications//request_rules/order \ --header 'Accept: application/json' \ --header 'Authorization: Token ' \ --header 'Content-Type: application/json' \ --data '{ "order": [, ] }' ``` A lista deve nomear todas as regras da fase. O campo `order` de cada regra passa então a guardar a sua nova posição, a partir de `0`. **CLI** Para ler a ordem, liste as regras da fase com a sua posição: ```bash azion list rules-engine --application-id --phase request --details ``` A saída adiciona as colunas `ORDER`, `PHASE` e `ACTIVE` às colunas `ID` e `NAME`. `ORDER` começa em `0`, e a regra de geolocalização deve ter um número maior que o da regra padrão. Para definir a ordem, passe todos os IDs de regra da fase, a regra padrão primeiro: ```bash azion update rules-engine-order --application-id --phase request --rule-ids "," ``` O comando confirma a nova ordem: ```text Ordered Rules Engine of Application with ID ``` A regra de geolocalização é executada depois da regra padrão, então o seu connector vence para as requisições a que ela corresponde. > **nota** > > A cache key padrão guarda o esquema, o host e o caminho, e nenhuma localização. Quando as origens regionais respondem o mesmo caminho com conteúdos diferentes, um cache setting aplicado a esse caminho pode servir a cópia de uma região a outra. Para o formato da key, consulte [Cache keys](/pt-br/documentacao/plataforma/applications/cache/cache-keys/). Para testar a regra, envie uma requisição de uma máquina na região a que ela corresponde, porque a regra lê a localização do endereço IP do cliente. Para ver quais regras foram executadas em uma requisição, ative [Debug Rules](/pt-br/documentacao/plataforma/applications/main-settings/#debug-rules). --- ## Próximos passos - [Rules Engine para Applications](/pt-br/documentacao/plataforma/applications/rules-engine.md#variaveis): Todas as variáveis de geolocalização que uma regra lê, do continente à região. - [Como Applications funciona](/pt-br/documentacao/plataforma/applications/como-funciona.md#behaviors-que-se-repetem): Por que o último Set Connector que corresponde vence, e como a ordem das regras define um padrão. - [Métodos de balanceamento](/pt-br/documentacao/plataforma/connectors/load-balancer/metodos-de-balanceamento.md#funcao-do-servidor): Dê a um connector regional uma origem de backup com as funções Primary e Backup. - [Rotear usuários para origens regionais](/pt-br/documentacao/casos-de-uso/melhorar-performance-e-confiabilidade/rotear-usuarios-para-origens-regionais.md): Envie usuários europeus a uma origem europeia, com uma região de backup só onde a residência de dados permite.