Crie um cache setting
Crie um cache setting em uma aplicação e aplique-o com uma regra, pelo Azion Console, pela Azion API ou pela Azion CLI.
Você cria um cache setting em uma aplicação pelo Azion Console, pela Azion API v4 ou pela Azion CLI, e o aplica às requisições com uma regra do Rules Engine. Um setting carrega os TTLs e as regras de variação; enquanto uma regra não o nomear pelo behavior Set Cache Policy, ele não se aplica a nenhuma requisição.
Para um primeiro cache setting apenas pelo Console, consulte Primeiros passos com Cache. Para variar o cache por um argumento de query string ou por um cookie, consulte Configure a Advanced Cache Key para uma aplicação.
Pré-requisitos
- Uma aplicação. Para criar uma, consulte Primeiros passos com Applications.
- Acesso ao Azion Console, para os procedimentos pelo Console. Consulte Como acessar o Azion Console.
- Um personal token, para os procedimentos pela API.
- A Azion CLI instalada e autorizada, para os procedimentos pela CLI.
- O Application Accelerator na aplicação, para um Max Age abaixo de 60 segundos ou para variação de cache.
Crie o cache setting pelo Azion Console
O drawer Create Cache Settings carrega cada campo de um setting. Para criar um:
Acesse Azion Console > Applications e selecione a aplicação.
Em Name, insira um nome único e descritivo.
Em Browser Cache, selecione uma opção. Honor cache policies repassa ao browser os headers Cache-Control e Expires da origem. Override cache settings os substitui por um TTL que você insere. No cache desativa o cache no browser, de modo que o conteúdo é sempre buscado no servidor.
Em Cache, selecione Honor cache policies para manter os headers da origem, ou Override cache behavior para substituí-los.
Em Max Age, insira os segundos que a Azion mantém uma cópia. Um setting novo carrega 60.
Com o toggle ativo, a Azion entrega uma cópia expirada quando uma tentativa de revalidação com a origem falha.
Com o toggle ativo, a Azion coloca um objeto grande em cache em fragmentos, e não como uma peça única.
O toggle adiciona uma segunda camada de cache entre o cache da Azion e a origem. Ele exige Override cache behavior e um Max Age de pelo menos 3 segundos.
O setting aparece na lista de Cache Settings com o seu Name, ID, Browser Cache e Cache. Para cada campo, com o seu tipo, o seu padrão e os seus limites, consulte Cache settings.
Aplique o setting com uma regra
Uma regra na request phase decide quais requisições o setting cobre. Para criá-la:
Em Criteria, selecione ${uri}, um operador e o argumento que casa os paths a colocar em cache.
Em Behaviors, selecione Set Cache Policy e depois selecione o cache setting.
A regra aparece na lista e aplica o setting a cada requisição que os seus criteria casam.
Crie o cache setting pela API
Duas requisições criam o setting e a regra que o aplica. Para enviá-las:
A API responde com HTTP 201, state igual a executed e o novo setting em data:
Substitua [CACHE SETTING ID] pelo id que a resposta retornou:
A API responde com HTTP 202 e a regra com state igual a pending, porque uma regra nova propaga antes de se aplicar:
O setting agora se aplica a cada requisição cujo path começa com o argumento. Para listar os settings de uma aplicação, envie um GET para o mesmo path cache_settings.
Crie o cache setting pela Azion CLI
A CLI cobre parte do objeto com flags, e o objeto inteiro com um arquivo JSON. Para criar um setting por flags:
O objeto carrega o browser cache e os campos de variação que as flags definiram, e o modules.cache nos seus padrões: honor e 60.
Para criar um setting com os campos que as flags não cobrem, envie o corpo da requisição a partir de um arquivo:
Salve o corpo da requisição da API acima como cache-setting.json.
O comando imprime o id do novo setting:
A CLI não cria a regra que aplica o setting. Crie-a pelo Console ou pela API, com qualquer um dos procedimentos desta página. Para cada flag, consulte Azion CLI create.