Crie uma regra de aplicação

Você pode criar uma regra no Rules Engine para Applications pelo Azion Console, pela Azion CLI ou pela API. Uma regra executa seus behaviors em toda requisição que corresponde aos seus critérios. A aplicação muda o que faz, e o seu código continua como está. As regras também são a forma como a aplicação usa os seus cache settings, instâncias de função e connectors. A regra desta página aplica um cache setting aos caminhos que começam com /static/.

Para reescrever o caminho de uma requisição ou remover o header Server das respostas, consulte Crie regras de request e response. Um firewall tem regras próprias. Para essas regras, consulte Crie uma regra de firewall.

Pré-requisitos

Console

Uma aplicação que serve o seu tráfego por meio de um workload. Para criar uma, consulte Primeiros passos com Applications.
Um cache setting nessa aplicação. Para criar um, consulte Crie um cache setting.
Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.

CLI

Uma aplicação que serve o seu tráfego por meio de um workload. Para criar uma, consulte Primeiros passos com Applications.
Um cache setting nessa aplicação. Para criar um, consulte Crie um cache setting.
Azion CLI instalada e autorizada com a sua conta. Os comandos desta página correspondem à Azion CLI 4.23.0. Para mais informações, consulte Azion CLI.
O ID da aplicação. Azion Console o mostra no endereço da página da aplicação, depois de /applications/edit/.
O ID do cache setting. A aba Cache Settings da aplicação o lista na coluna ID.

API

Uma aplicação que serve o seu tráfego por meio de um workload. Para criar uma, consulte Primeiros passos com Applications.
Um cache setting nessa aplicação. Para criar um, consulte Crie um cache setting.
Um personal token, enviado no header Authorization como Token [TOKEN VALUE]. Para criar um, consulte Como criar um personal token.
curl ou outro cliente HTTP.
O ID da aplicação. Azion Console o mostra no endereço da página da aplicação, depois de /applications/edit/.
O ID do cache setting. A aba Cache Settings da aplicação o lista na coluna ID.

Aplique um cache setting a um caminho

A regra desta seção é executada na Request Phase. Ela corresponde às requisições cujo ${uri} começa com /static/. O behavior Set Cache Policy dela aplica o seu cache setting a essas requisições. As requisições para outros caminhos mantêm o comportamento de cache que já tinham. O critério também corresponde a caminhos mais longos, como /static/css/site.css.

A fase de uma regra é fixada quando você a cria. Para executar um behavior na Response Phase em vez disso, crie uma nova regra nessa fase.

A variável ${uri} não precisa de nenhum Produto na aplicação. Set Cache Policy depende de Cache, que toda aplicação nova executa. Outras variáveis e behaviors precisam de Application Accelerator, Image Processor ou Functions habilitado na aplicação. No Azion Console, cada uma dessas opções carrega uma nota como - Required Application Accelerator. Para habilitar um Produto, consulte Habilite Produtos em uma aplicação.

Console

Para criar a regra pelo Azion Console:

Abra a aplicação

Acesse Azion Console > Applications e selecione a sua aplicação.

Selecione a aba Rules Engine

Selecione + Rule

Nomeie a regra

Na seção General, insira um Name, como apply-static-assets-cache.

(Opcional) Descreva a regra

Em Description, insira uma nota sobre o que a regra faz. A nota aceita até 1.000 caracteres.

Selecione a fase

Na seção Phase, selecione Request Phase.

Selecione a variável

Na seção Criteria, selecione ${uri} como variável.

Selecione o operador

Selecione starts_with como operador.

Insira o argumento

Insira /static/ como argumento.

Selecione o behavior

Na seção Behaviors, selecione Set Cache Policy.

Selecione o cache setting

No segundo dropdown do behavior, selecione o seu cache setting.

Mantenha a regra ativa

Em Status, confirme que Active está ativado.

Selecione Save

A regra aparece na aba Rules Engine, sob o título Request. Para executar um segundo behavior na mesma regra, selecione + Add Behavior antes de salvá-la.

CLI

Para criar a regra pela Azion CLI, salve a definição dela como rule.json. O arquivo contém o name da regra, uma description opcional, se ela está active, os criteria e os behaviors dela:

JSON

01{

02 "name": "apply-static-assets-cache",

03 "description": "Applies the static-assets cache setting to /static/",

04 "active": true,

05 "criteria": [

06 [

07 {

08 "variable": "${uri}",

09 "operator": "starts_with",

10 "conditional": "if",

11 "argument": "/static/"

12 }

13 ]

14 ],

15 "behaviors": [

16 {

17 "type": "set_cache_policy",

18 "attributes": {

19 "value": "<cache-setting-id>"

20 }

21 }

22 ]

23}

criteria é uma lista de grupos, e cada grupo é uma lista de condições. A primeira condição recebe "conditional": "if". No behavior set_cache_policy, attributes.value contém o ID do seu cache setting.

Em seguida, crie a regra na fase de requisição, com o ID da sua aplicação no lugar de <application-id>:

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

O comando imprime o ID da nova regra:

Created Rules Engine with ID <rule-id>

A flag --phase define a fase da regra. O arquivo contém o mesmo corpo que a API aceita.

API

Para criar a regra pela API, envie uma requisição POST ao endpoint request_rules da sua aplicação. O endpoint define a fase, e o corpo carrega name, description, active, criteria e behaviors da regra:

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 [TOKEN VALUE]' \

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

06 --data {

07 "name": "apply-static-assets-cache",

08 "description": "Applies the static-assets cache setting to /static/",

09 "active": true,

10 "criteria": [

11 [

12 {

13 "variable": "${uri}",

14 "operator": "starts_with",

15 "conditional": "if",

16 "argument": "/static/"

17 }

18 ]

19 ],

20 "behaviors": [

21 {

22 "type": "set_cache_policy",

23 "attributes": {

24 "value": "<cache-setting-id>"

25 }

26 }

27 ]

28}

A API responde 202 e retorna a regra:

{"state":"pending","data":{"id":<rule-id>,…,"behaviors":[{"type":"set_cache_policy","attributes":{"value":<cache-setting-id>}}],"order":0,…}}

A resposta adiciona o id e o order da regra e retorna o ID do cache setting como número. O order é a posição da regra entre as regras de requisição da aplicação, contada a partir de 0. A primeira regra de requisição de uma aplicação recebe 0, e a seguinte recebe 1.

Enquanto Application Accelerator estiver desativado na aplicação, a API recusa um critério em ${request_uri} com 400:

{"errors":[{"code":"25047","title":"Missing Required Modules","detail":" It requires any of the following modules to be enabled: ['application_accelerator'].","status":"400","source":{"pointer":"/data/criteria/0/0/variable"},"meta":{"message_prefix":"","owner_modules":"any","missing_required_modules":["application_accelerator"]}}]}

Use ${uri}, que não precisa de nenhum Produto, ou habilite Application Accelerator antes de enviar a regra. Para todas as variáveis, operadores e behaviors que o corpo aceita, consulte Rules Engine para Applications e a referência da Azion API.

Uma nova regra pode levar alguns minutos para se propagar. Para ler o status de cache de uma resposta em /static/, consulte Verifique o status de cache de uma resposta.

Próximos passos

Rules Engine para ApplicationsCada variável, operador e behavior que uma regra de aplicação aceita, por fase.Crie regras de request e responseReescreva o caminho de uma requisição e remova o header Server das respostas, no Azion Console.Verifique o status de cache de uma respostaLeia se uma resposta no caminho da regra veio do cache.Habilite Produtos em uma aplicaçãoAtive Application Accelerator, Image Processor ou Functions para usar as variáveis e os behaviors que eles adicionam.Crie device groupsAgrupe dispositivos por User-Agent para gerenciar os behaviors da aplicação e as políticas de cache de cada grupo.