Purgue páginas quando a origem publica uma mudança

Envie um purge pelo seu sistema de publicação quando o conteúdo muda: por URL a cada salvamento e por wildcard só quando imagens mudam.

Última atualização

Ver como Markdown Configurar agente

Você faz um sistema de publicação, como um CMS, uma plataforma de e-commerce ou um pipeline de build, purgar as páginas que ele muda pela Azion API ou pela Azion CLI, e envia o mesmo purge manualmente pelo Azion Console. Para um purge avulso de qualquer tipo, consulte Purgue conteúdo em cache.

Uma mudança publicada só chega aos visitantes depois que a cópia em cache sai do cache. O sistema de publicação sabe quais páginas mudaram, então ele envia o purge no momento em que as salva, e o TTL do cache fica como um limite de segurança para um purge que não for enviado.

  1. A cada salvamento, o sistema de publicação envia um purge por URL da página alterada e das páginas que a listam.
  2. Só quando o salvamento muda imagens, ele também envia um purge por wildcard de todos os tamanhos e formatos dessas imagens.
  3. Cada purge aparece no histórico de purges quando termina, e a requisição seguinte por cada objeto chega à origem.

Pré-requisitos

  • Um domínio que pertença à sua conta, servido por uma aplicação. Um purge de qualquer outro domínio é rejeitado com o erro 30003.
  • Um personal token para a API e a CLI. Um token expira 1 dia depois de criado, a menos que você escolha uma expiração maior, então defina uma que cubra o tempo em que o sistema de publicação roda e substitua o token antes que ele expire.
  • A Azion CLI instalada e autorizada, para o procedimento pela CLI.
  • Acesso ao Azion Console, para o procedimento pelo Console. Consulte Acesse o Azion Console.

Os exemplos purgam a página de produto https://www.example.com/products/blue-shirt, a sua página de categoria https://www.example.com/category/shirts e as imagens em www.example.com/media/blue-shirt. Substitua-os pelos objetos que o seu salvamento muda.

Purgue as páginas alteradas a cada salvamento

Um purge por URL remove as URLs exatas que lista. Ele não é recursivo, então liste cada página que a mudança afeta: a própria página e cada página que mostra o conteúdo alterado, como uma página de categoria ou uma página inicial. Uma requisição carrega até 50 URLs. Uma URL sem esquema purga as cópias HTTP e HTTPS.

Para enviar o purge por URL manualmente:

Abra o Real-Time Purge

Acesse Azion Console > Products Menu > Real-Time Purge.

Selecione New Purge
Escolha o tipo de purge por URL e a camada Cache
Insira as URLs

Insira uma URL por item: https://www.example.com/products/blue-shirt e https://www.example.com/category/shirts.

Selecione Purge

Uma mensagem confirma a criação, e a Azion coloca o purge na fila.

As páginas listadas saem do cache quando o purge se propaga. Um purge por URL não alcança as cópias que variam por cookie, device group ou formato de imagem, e a próxima seção trata desse caso para imagens.

Purgue as variações de imagem quando uma imagem muda

O Image Processor guarda em cache uma cópia de uma imagem por tamanho e por formato, e um purge por URL não alcança nenhuma dessas cópias. Um purge por wildcard terminado em * alcança todas. Envie-o só quando o salvamento muda uma imagem: a Azion aceita 2.000 requisições de purge por wildcard em um intervalo de 24 horas, e um wildcard a cada salvamento de um catálogo grande pode chegar a esse limite. Uma requisição carrega uma expressão de até 256 caracteres.

Para enviar o purge por wildcard manualmente:

Abra o Real-Time Purge

Acesse Azion Console > Products Menu > Real-Time Purge.

Selecione New Purge
Escolha o tipo de purge por wildcard e a camada Cache
Insira a expressão

Insira www.example.com/media/blue-shirt*.

Selecione Purge

Uma mensagem confirma a criação, e a Azion coloca o purge na fila.

Todos os tamanhos e formatos das imagens alteradas saem do cache. Quando o sistema de publicação conhece as variações exatas que serve, um purge por cache key que lista cada key faz o mesmo trabalho sem contar no limite de wildcard. Uma key carrega os argumentos de processamento depois de ? e o formato depois de @@, como em httpswww.example.com/media/blue-shirt.jpg?ims=400x@@webp. Para o formato, consulte Cache keys.

Confirme que o purge terminou

Um 201 da API significa que o purge foi aceito, não que ele se propagou. A Azion lista um purge no histórico de purges quando ele termina. Para confirmar:

Abra o Real-Time Purge

Acesse Azion Console > Products Menu > Real-Time Purge.

Encontre o purge no histórico

O histórico lista cada purge concluído e pode ser filtrado pelo usuário que o fez, pelo horário, pela lista de argumentos, pelo tipo de purge e pelo método. Filtre pela lista de argumentos para encontrar a URL ou a expressão que você enviou.

Requisite a página com o header de debug
curl -sI -H "Pragma: azion-debug-cache" https://www.example.com/products/blue-shirt
Leia o status de cache

A resposta carrega MISS, porque a Azion buscou a página na origem de novo:

x-cache: MISS from 192.0.2.10 with HTTP/2.0

O purge está no histórico, e a página servida depois dele é a versão que a origem publicou. A requisição seguinte volta a carregar HIT.

nota — Um sistema de publicação que salva muitos objetos de uma vez, como uma importação de catálogo, envia as URLs em lotes de 50 ou menos. A Azion aceita 10.000 objetos de URL e de cache key a cada 60 segundos. Para todos os limites de purge, consulte Limites do Real-Time Purge.

Próximos passos

Purgue conteúdo em cachePurgue por cache key, purgue a camada do Tiered Cache e purgue objetos que variam.Real-Time PurgeTodos os tipos de purge, as variações que cada um alcança, os erros e os limites.Criar vitrines de e-commerceUma vitrine que purga páginas de produto pela plataforma de e-commerce a cada salvamento.Azion CLI purgeTodas as flags do comando azion purge.