Primeiros passos com Application Accelerator

Este guia conduz você pelo seu primeiro cache setting que varia a cache key. O exemplo é uma página de listagem cuja resposta muda com um argumento de query string.

• Ativar Application Accelerator em uma aplicação.
• Criar um cache setting que mantém a listagem por 30 segundos e varia pelo argumento category.
• Adicionar uma regra do Rules Engine que aplica o cache setting às requisições para /products.
• Requisitar a listagem duas vezes, com dois valores de category, e ler a cache key de cada resposta.

Três objetos produzem esse resultado, e cada um depende do anterior:

1. O switch Application Accelerator pertence à aplicação. Ele libera os campos que variam a cache key e remove o piso de 60 segundos do cache TTL.
2. O cache setting carrega o behavior de cache, o Max Age e a variação. Ele define o que o cache faz, não a quais requisições ele faz isso.
3. A regra do Rules Engine aplica o cache setting com o behavior Set Cache Policy. Os critérios dela decidem quais requisições o cache setting cobre.

Criar um cache setting não altera nenhum tráfego. Um cache setting que nenhuma regra aplica nunca alcança uma requisição.

azion.config.js e Azion Lib carregam as mesmas configurações. Para o campo que cada interface define, consulte Configurações do Application Accelerator.

Selecione a interface que você vai usar. Os pré-requisitos e todas as etapas abaixo seguem essa escolha.

Pré-requisitos

• Uma conta Azion. Para criar uma, consulte Como criar uma conta na Azion.
• A permissão Edit Applications na conta. Ela concede permissão para editar, criar e remover aplicações, e também requer a permissão View Applications. Consulte Teams Permissions.
• Uma aplicação que serve um path cuja resposta muda com um argumento de query string. Este guia usa o path /products e o argumento category. Para criar uma aplicação, consulte Primeiros passos com Applications.

Ative Application Accelerator

O módulo vem desativado por padrão e pertence a uma aplicação por vez.

Crie um cache setting que varia por query string

Um cache setting é onde ficam o behavior de cache e a variação. O Max Age de 30 segundos abaixo é o ponto do exercício: sem Application Accelerator, o menor cache TTL que uma aplicação aceita é 60 segundos.

Aplique o cache setting com uma regra

Um cache setting alcança uma requisição apenas quando uma regra o aplica.

Uma nova regra leva alguns minutos para propagar. Aguarde antes de requisitar o path.

Leia a cache key

A Azion retorna a cache key de um objeto quando a requisição carrega o header de debug da Azion Pragma: azion-debug-cache. Ler essa key para dois valores de category mostra a variação que o cache setting criou.

Sua aplicação responde em um domínio no formato xxxxxxxxx.map.azionedge.net. Para definir o domínio da sua aplicação, consulte Adicione um domínio a um workload.

Substitua <your-azion-domain> por esse domínio e requisite a listagem com um valor:

A resposta carrega dois headers de debug da Azion. Este trecho é de uma aplicação servida em www.example.com, e HTTP/2 envia os nomes dos headers em minúsculas:

x-cache carrega o status de cache, o endereço do data center que respondeu e o protocolo da requisição. x-cache-key carrega a cache key, que concatena o scheme, o host, o path e os argumentos de query string que a allowlist nomeou.

Requisite o mesmo path com um valor diferente:

O argumento mudou, então a key mudou junto:

Duas keys são dois objetos em cache, que é o que a allowlist pediu. Para o formato completo de uma cache key, consulte Formato da cache key.

Sua aplicação agora mantém a listagem /products em cache por 30 segundos e guarda um objeto por valor de category.

Próximos passos