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.

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}}}%%

02flowchart TD

03 Req["Uma requisição chega à aplicação"] --> R1["Regra 1: todos os caminhos, Set Connector origin-default"]

04 R1 --> R2{"Regra 2: o continente ou o país corresponde?"}

05 R2 -->|"sim: a última correspondência vence"| Reg["origin-regional"]

06 R2 -->|"não"| Def["origin-default permanece"]

Toda requisição corresponde à primeira regra, que define origin-default.
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.
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.
Um segundo connector, para a região. Para criar um, consulte Primeiros passos com Connectors.
Um personal token, para os procedimentos pela API.
A Azion CLI instalada e autorizada, para os procedimentos pela CLI.

Os exemplos usam origin-default para o connector padrão, origin-regional com o ID <connector-id> para o regional e a aplicação <application-id>. 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.

Os procedimentos correspondem ao continente NA. Para uma lista de países, troque o critério pelo da tabela.

Para criar a regra no Azion Console:

Vá para a aba Rules Engine

Acesse Azion Console > Applications > sua aplicação e vá para a aba Rules Engine.

Selecione + Rule

Nomeie a regra

Insira um nome que identifique a região. Por exemplo: geo - north america.

Selecione Request Phase

Corresponda ao continente

Na seção Criteria, defina o critério como ${geoip_continent_code} is equal NA.

Defina o connector

Na seção Behaviors, selecione Set Connector e, em seguida, selecione origin-regional.

Selecione Save

A regra aparece na lista Request da aba Rules Engine.

Os critérios carregam ${geoip_continent_code}, que um shell expande, então o corpo é enviado de um arquivo. Para criar a regra:

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

01{

02 "name": "geo - north america",

03 "active": true,

  "criteria": [[{ "variable": "${geoip_continent_code}", "conditional": "if", "operator": "is_equal", "argument": "NA" }]],

05 "behaviors": [{ "type": "set_connector", "attributes": { "value": <connector-id> } }]

06}

Envie a requisição de criação

Shell

01curl --request POST \

02 --url https://api.azion.com/v4/workspace/applications/<application-id>/request_rules \

03 --header 'Accept: application/json' \

04 --header 'Authorization: Token <personal-token>' \

05 --header 'Content-Type: application/json' \

06 --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.

A CLI lê a regra de um arquivo JSON. Para criar a regra:

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

01{

02 "name": "geo - north america",

03 "active": true,

  "criteria": [[{ "variable": "${geoip_continent_code}", "conditional": "if", "operator": "is_equal", "argument": "NA" }]],

05 "behaviors": [{ "type": "set_connector", "attributes": { "value": <connector-id> } }]

06}

Crie a regra

azion create rules-engine --application-id <application-id> --phase request --file rule.json

O comando imprime o ID da regra:

Created Rules Engine with ID <rule-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.

Para verificar a ordem no Azion Console:

Vá para a aba Rules Engine

Acesse Azion Console > Applications > sua aplicação e vá para a aba Rules Engine.

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.

Para definir a ordem, envie os IDs das regras da fase na nova ordem, a regra padrão primeiro, no array order:

Shell

01curl --request PUT \

02 --url https://api.azion.com/v4/workspace/applications/<application-id>/request_rules/order \

03 --header 'Accept: application/json' \

04 --header 'Authorization: Token <personal-token>' \

05 --header 'Content-Type: application/json' \

06 --data '{ "order": [<default-rule-id>, <geo-rule-id>] }'

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.

Para ler a ordem, liste as regras da fase com a sua posição:

azion list rules-engine --application-id <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:

azion update rules-engine-order --application-id <application-id> --phase request --rule-ids "<default-rule-id>,<geo-rule-id>"

O comando confirma a nova ordem:

Ordered Rules Engine of Application with ID <application-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.

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.

Próximos passos

Rules Engine para ApplicationsTodas as variáveis de geolocalização que uma regra lê, do continente à região.Como Applications funcionaPor que o último Set Connector que corresponde vence, e como a ordem das regras define um padrão.Métodos de balanceamentoDê a um connector regional uma origem de backup com as funções Primary e Backup.Rotear usuários para origens regionaisEnvie usuários europeus a uma origem europeia, com uma região de backup só onde a residência de dados permite.