Como configurar a Advanced Cache Key para Edge Application

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.

Para ativar a Advanced Cache Key para uma edge application:

  1. Acesse o Azion Console > Edge Application.
  2. Selecione a edge application que deseja configurar ou crie uma nova.
  3. Na aba Main settings, na seção Modules, ative a opção Application Accelerator.
  4. Clique no botão Save.

Crie 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:

  1. Acesse o Azion Console > Edge Application.
  2. Selecione a aplicação e verifique se o Application Accelerator está ativo.
  3. Clique na aba Cache Settings.
  4. Clique no botão + Cache Setting.
  5. Dê à sua configuração um nome fácil de lembrar.
  6. Tanto na seção Browser Cache Settings quanto em Edge Cache Settings:
    • Marque a opção Override Cache Settings.
    • Defina o Maximum TTL (seconds) para 300 (5 minutos).
  7. 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 (Allowlist).
    • Nos Query String fields, insira o valor cidade.
  8. 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 + Rule.
  3. Dê à sua configuração um nome fácil de lembrar.
  4. Selecione Request Phase.
  5. 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
  6. Na seção Behaviors:
    • Selecione o comportamento Set Cache Policy.
    • Selecione a configuração de cache que você criou para a Query String cidade.
  7. 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.

Crie 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:

  1. Acesse o Azion Console > Edge Application.
  2. Selecione a aplicação e verifique se o Application Accelerator está ativo.
  3. Clique na aba Cache Settings.
  4. Clique no botão + Cache Setting.
  5. Dê à sua configuração um nome fácil de lembrar.
  6. Configure Browser Cache Settings e Edge Cache Settings conforme desejado.
  7. 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.
  8. 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
  3. Dê à sua configuração um nome fácil de lembrar.
  4. Selecione Request Phase.
  5. 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
  6. Na seção Behaviors:
    • Selecione o comportamento Set Cache Policy.
    • Selecione a configuração de cache que você criou para o session_cookie.
  7. 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