Primeiros passos com Cache
Crie um cache setting pelo Azion Console, pela Azion CLI ou pela API, aplique-o a um path com uma regra do Rules Engine e leia o status de cache.
Este guia orienta você a colocar em cache um path da sua aplicação pela primeira vez. No fim, você vai ter:
- Um cache setting que mantém uma cópia de cada resposta por 300 segundos.
- Uma regra do Rules Engine que aplica o setting a um prefixo de path.
- O status de cache de uma resposta, lido no seu header
x-cache.
O resultado se apoia em quatro objetos, nesta ordem. A aplicação carrega o módulo Cache, que está ativo em cada aplicação. O cache setting pertence à aplicação e carrega o TTL, o tempo que a Azion mantém uma cópia. A regra, também na aplicação, casa requisições por path e aplica o setting pelo behavior Set Cache Policy. Uma requisição que casa é respondida pela cópia armazenada quando existe uma, e a sua resposta carrega o x-cache com HIT. Enquanto uma regra não o nomear, um cache setting não faz nada.
Selecione a interface que você vai usar. Os pré-requisitos e todas as etapas abaixo seguem essa escolha.
Pré-requisitos
- Uma aplicação que já entrega conteúdo em um domínio. Para criar uma, consulte Primeiros passos com Applications.
- A URL de um objeto estático que a aplicação entrega, como uma imagem, para verificar no fim.
- O
curlna sua máquina, para a verificação do status de cache no fim.
- Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.
Crie um cache setting
Um cache setting carrega por quanto tempo a Azion mantém uma cópia de uma resposta. Este mantém cada cópia por 300 segundos.
Para criar o cache setting pelo Azion Console:
Acesse Azion Console > Applications e selecione a aplicação que entrega o seu conteúdo.
Em Name, insira static-assets.
Em Cache, mantenha Override cache behavior selecionado. Com essa opção, o Max Age substitui o TTL enviado pela origem.
Em Max Age, substitua 60 por 300.
O novo setting aparece na lista de Cache Settings, que mostra o seu Name, ID, Browser Cache e Cache.
Aplique o setting com uma regra
Um cache setting não faz nada enquanto uma regra não o nomear. Esta regra aplica o static-assets a cada requisição cujo path casa com um prefixo que você escolhe.
Para criar a regra pelo Azion Console:
Insira um nome como cache-static-assets.
Em Criteria, selecione ${uri} e um operador. Como argumento, insira o prefixo de path a colocar em cache, como /static/.
Em Behaviors, selecione Set Cache Policy e depois selecione static-assets.
A regra aparece na lista e aplica o static-assets a cada requisição cujo path casa com os seus criteria.
Verifique o status de cache
O header de requisição Pragma: azion-debug-cache faz a resposta carregar dois headers de debug. O x-cache carrega o status de cache, o IP do servidor que respondeu e o protocolo. O x-cache-key carrega a key que indexa a cópia.
Requisite um objeto sob o path que a regra casa, com o seu próprio host e path:
A resposta carrega os dois headers de debug. Em HTTP/2, os nomes dos headers chegam em minúsculas:
MISS significa que o objeto não estava no cache: a Azion o buscou na origem e pode armazenar a resposta.
Uma resposta entregue pela cópia armazenada carrega HIT. O x-cache também nomeia o servidor que respondeu.
A sua aplicação agora mantém uma cópia de cada resposta que casa por 300 segundos. O x-cache informa quando uma resposta veio dessa cópia. Uma resposta também pode carregar outro status, como REVALIDATED. Para cada valor de status, consulte Cache keys.