• Guias
• Advanced Cache Key

O Azion Application Accelerator 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:

1. Acesse o Azion Console.
2. No canto superior esquerdo da página, selecione o Products menu, representado por três linhas horizontais.
3. Na seção BUILD, clique em Edge Application.
4. Selecione a edge application que deseja configurar ou crie uma nova.
5. Na aba Main settings, na seção Modules, ative a opção Application Accelerator.
6. Clique no botão Save.

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:

1. Acesse o Azion Console.
2. No canto superior esquerdo da página, selecione o Products menu, representado por três linhas horizontais.
3. Na seção BUILD, clique em Edge Application.
4. Selecione a aplicação e verifique se o Application Accelerator está ativo.
5. Clique na guia Cache Settings.
6. Clique no botão Add Cache Settings e dê à sua configuração um nome fácil de lembrar.
7. 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).
8. 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.
9. 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:

1. Clique na aba Rules Engine.

2. Clique no botão New Rule e selecione Request Phase.

3. 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

4. Na seção Behaviors:

   • Selecione o comportamento Set Cache Policy.
   • Selecione a configuração de cache que você criou para a Query String cidade.

5. 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.

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:

1. Acesse o Azion Console.
2. No canto superior esquerdo da página, selecione o Products menu, representado por três linhas horizontais.
3. Na seção BUILD, clique em Edge Application.
4. Selecione a aplicação e verifique se o Application Accelerator está ativo.
5. Clique na guia Cache Settings.
6. Clique no botão Add Cache Settings e dê à sua configuração um nome fácil de lembrar.
7. Configure Browser Cache Settings e CDN Cache Settings conforme desejado.
8. 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.
9. Clique no botão Save.

O próximo passo é ativar uma regra no Rules Engine para a página /perfil da seguinte forma:

1. Clique na aba Rules Engine.

2. Clique no botão New Rule e selecione Request Phase.

3. 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

4. Na seção Behaviors:

   • Selecione o comportamento Set Cache Policy.
   • Selecione a configuração de cache que você criou para o session_cookie.

5. 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.

Contribuidores