Como configurar a Advanced Cache Key para Edge Application
O Azion Application Acceleration habilita a funcionalidade Advanced Cache Key, que permite que você crie regras de cache com base em Query Strings da URL e Cookies. Você pode aplicar essas regras a uma aplicação dinâmica usando o Rules Engine.
Se você quiser definir configurações de cache para conteúdo estático, consulte o guia Como configurar políticas de cache para Edge Application.
Para ativar a Advanced Cache Key para uma edge application:
- Acesse o Real-Time Manager (RTM).
- No canto superior esquerdo da página, selecione o Products menu, representado por três linhas horizontais.
- Na seção BUILD, clique em Edge Application.
- Selecione a edge application que deseja configurar ou crie uma nova.
- Na aba Main settings, na seção Modules, ative a opção Application Acceleration.
- Clique no botão Save.
Criando regras avançadas de cache para conteúdo dinâmico com base em Query Strings
Para ilustrar melhor o uso da Advanced Cache Key com base em Query Strings, suponha que sua aplicação tem a seguinte URL: dominio.com/pagina?cidade=nome_cidade
.
A URI /pagina
tem uma API, chamada pela Query String ?cidade=nome_cidade
, que lista o conteúdo dependendo da cidade do usuário. O conteúdo da página é atualizado automaticamente a cada cinco minutos.
Para combinar o TTL do cache com o tempo de atualização do conteúdo chamado pelo campo cidade
:
- Acesse o RTM.
- No canto superior esquerdo da página, selecione o Products menu, representado por três linhas horizontais.
- Na seção BUILD, clique em Edge Application.
- Selecione a aplicação e verifique se o Application Acceleration está ativo.
- Clique na guia Cache Settings.
- Clique no botão Add Cache Settings e dê à sua configuração um nome fácil de lembrar.
- Tanto na seção Browser Cache Settings quanto em CDN Cache Settings:
- Marque a opção Override Cache Settings.
- Defina o Maximum TTL (seconds) para
300
(5 minutos).
- Na seção Advanced Cache Key, defina seu Cache by Query String da seguinte forma:
- Selecione a opção Content varies by some Query String fields (Whitelist).
- Nos Query String fields, insira o valor
cidade
.
- Clique no botão Save.
Agora, há um objeto de política de cache com a Query String cidade
que pode ser ativado no Rules Engine da seguinte forma:
- Clique na aba Rules Engine.
- Clique no botão New Rule e selecione Request Phase.
-
Na seção Criteria, defina os critérios que acionam o comportamento sempre que o URI
/pagina
for acessado da seguinte forma:If
${uri}
starts with/pagina
- Na seção Behaviors:
- Selecione o comportamento Set Cache Policy.
- Selecione a configuração de cache que você criou para a Query String
cidade
.
- Clique no botão Save.
Pronto. Agora o conteúdo será armazenado em cache no navegador e na origem pelo mesmo tempo que a API leva para atualizar sua aplicação.
Criando regras avançadas de cache para conteúdo dinâmico com base em Cookies
Se sua aplicação usa autenticação baseada em cookies, você pode usar a Advanced Cache Key para garantir que o conteúdo em cache varie de acordo com cada cookie de sessão.
Por exemplo, cada vez que um usuário faz login em sua conta em uma edge application, ele é direcionado para uma página /perfil
. O conteúdo da página de perfil do usuário deve variar dependendo de um cookie chamado session_cookie
que passa a ter um valor após um login bem-sucedido.
Para garantir que todos os usuários vejam uma página diferente dependendo do cookie de sessão:
- Acesse o RTM.
- No canto superior esquerdo da página, selecione o Products menu, representado por três linhas horizontais.
- Na seção BUILD, clique em Edge Application.
- Selecione a aplicação e verifique se o Application Acceleration está ativo.
- Clique na guia Cache Settings.
- Clique no botão Add Cache Settings e dê à sua configuração um nome fácil de lembrar.
- Configure Browser Cache Settings e CDN Cache Settings conforme desejado.
- Na seção Advanced Cache Key, defina seu Cache by Cookie da seguinte forma:
- Selecione a opção Content varies by some Cookies.
- Em Cookie nomes, insira o valor
session_cookie
.
- Clique no botão Save.
O próximo passo é ativar uma regra no Rules Engine para a página /perfil
da seguinte forma:
- Clique na aba Rules Engine.
- Clique no botão New Rule e selecione Request Phase.
-
Na seção Criteria, defina os critérios que acionam o comportamento sempre que a URI
/perfil
for acessada da seguinte forma:If
${uri}
starts with/perfil
- Na seção Behaviors:
- Selecione o comportamento Set Cache Policy.
- Selecione a configuração de cache que você criou para o
session_cookie
.
- Clique no botão Save.
Pronto. Agora o objeto em cache para a página de perfil irá variar com base no cookie de sessão do usuário.
Não encontrou o que procurava? Abra um ticket.