Edge Security Acceleration:Limpar cache por tag

Benefícios

A limpeza de cache por tag simplifica a limpeza em massa de recursos em cache relacionados:

• Operações em lote eficientes: Atribua a mesma tag a um grupo de recursos relacionados — como uma página de notícias com imagens, arquivos JS e CSS — e limpe todos com uma única ação.

• O&M simplificado: Gerencie grupos lógicos de recursos por tag em vez de rastrear URLs individuais.

• Isolamento de cenários: Atribua tags diferentes a cenários distintos na mesma aplicação. A limpeza por tag afeta apenas o cenário visado — como uma página de promoção — sem impactar os demais.

• Atualizações consistentes: Garanta que recursos fortemente acoplados — como páginas frontend e seus ativos estáticos — sejam atualizados em conjunto, evitando inconsistências como páginas novas com estilos antigos.

Casos de uso

Casos de uso comuns:

• Atualizar páginas de promoção de e-commerce e ativos associados

• Remover conteúdo temático especial em sites de notícias ou mídia

• Alternar conteúdo em sites multilíngues ou com múltiplas versões

• Limpar recursos de sub-aplicações em uma arquitetura de micro-frontend

Como funciona

ESA usa cabeçalhos de resposta HTTP como tags de cache. Uma tag de cache é composta por um nome de cabeçalho e um valor de cabeçalho separados por dois pontos :, por exemplo, Cache-Tag:tag1,tag2,tag3. Ao enviar uma tarefa de limpeza de cache por tag:

1. ESA verifica se o arquivo em cache no POP possui uma tag de cache (padrão: Cache-Tag). Se não houver tag de cache, o ESA ignora o arquivo. Caso contrário, o ESA verifica o valor da tag.

2. O ESA verifica se o valor da tag corresponde ao Purge Content enviado. Se houver correspondência, o ESA limpa o cache (comportamento padrão: Mark as Expired). Se não, o ESA ignora o arquivo.

Pré-requisitos

ESA A limpeza de cache por tag verifica se o conteúdo em cache nos POPs do ESA contém tags de cache específicas definidas pela origem. Antes de usar este recurso, configure o servidor de origem para adicionar os cabeçalhos de resposta de tag de cache correspondentes:

# /etc/nginx/nginx.conf

server {
    listen 80;
    server_name your-origin-domain.com;
    # Add tag to all resources under /images/
    location /images/ {
        add_header Cache-Tag "images";
        # ... other configuration
    }
    # ... other location blocks
}

Procedimento

1. In the ESA console, choose Site Management. In the Website column, click your target site.

2. In the navigation pane on the left, choose Caching > Purge Cache.

3. Na guia Purge Cache, configure a regra de limpeza e clique em Submit:

   • Type: Selecione By Tag.

   • Purge Method: You can choose between two methods: Mark as Expired and Delete.

     Refresh method	Description
     Mark as Expired	Nodes are processed according to the following flow: The ESA POP sends an origin request with the If-Modified-Since and If-None-Match request headers. The origin server compares the file modification time. If the file is not modified, the origin server returns a 304 status code. The ESA POP can then use the existing cache file to respond to the client request. If the file is modified, the origin server returns a 200 status code and the latest file. The ESA POP returns the latest file to the client and caches the resource.
     Delete	If a user requests content that matches a resource to be refreshed, the ESA POP directly fetches the new resource from the origin, returns it to the user, and caches the new resource.

   • Purge Content: Insira o valor da tag a ser limpa. Separe múltiplos valores com ,, como images.

   

4. After you submit a purge task, track its progress on the Purge Records tab. 100% indicates completion. Large tasks may take longer.

   

Exemplos

Ao atualizar imagens ou páginas em um site de e-commerce, pode ser necessário limpar o cache do ESA correspondente. Para imagens com múltiplas versões recortadas, enumerar cada variante é impraticável — em vez disso, limpe em lote o cache do ESA para todas as variantes pelo nome da imagem. Da mesma forma, ao iterar páginas de eventos, limpe todo o cache do ESA relacionado pela tag de versão:

Descrição de tag de cache

Disponibilidade