1 of 20
2 of 20
3 of 20
4 of 20
5 of 20
6 of 20
7 of 20
8 of 20
9 of 20
10 of 20
11 of 20
12 of 20
13 of 20
14 of 20
15 of 20
16 of 20
17 of 20
18 of 20
19 of 20
20 of 20

doc

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:

  1. Acesse o Real-Time Manager (RTM).
  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 Acceleration.
  6. 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:

  1. Acesse o RTM.
  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 Acceleration 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 RTM.
  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 Acceleration 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.


Não encontrou o que procurava? Abra um ticket.