Regras de cache do eCDN e limpeza de cache

Onde as regras de cache e a limpeza de cache estão disponíveis

Para configurar regras de cache e limpar o cache, em Business Manager, vá para Administração | Sites | Configurações de CDN integrada e selecione Configurar zona para a zona desejada. As regras de cache e o botão Limpar cache estão disponíveis no escopo da zona para esses tipos de zona.

Como as zonas SCAPI diferem

Para zonas SCAPI, somente a limpeza de cache está disponível na instância de Production, e as regras de cache não são expostas. Esse comportamento é intencional. Há uma zona SCAPI para Desenvolvimento, Preparação e Produção. A zona não aparece no Business Manager ou na CDN API em Development ou Staging. Para obter a matriz de controle de zona SCAPI completa, consulte Suporte a zona SCAPI para B2C Commerce.

• O cache SCAPI é um recurso gerenciado por plataforma. Para evitar alterações no comportamento do cache SCAPI, o autoatendimento de regra de cache está desabilitado para essas zonas.
• Os operadores do SCAPI definem tags de cache automaticamente quando armazenam uma resposta em cache. Você mesmo não define tags para zonas SCAPI.
• O fluxo de invalidação do lado do com (JWA) sincroniza a invalidação do cache SCAPI.
• Limpe o conteúdo da zona SCAPI por tag ou por caminho da instância de Production.

Como o eCDN decide o que armazenar em cache

Entender a decisão de cache ajuda você a escrever regras eficazes.

Por padrão, quando nenhuma regra de cache é configurada, o eCDN armazena em cache somente por extensão de arquivo. As extensões estáticas comuns (imagens, JS, CSS, fontes, vídeo, documentos e arquivos) são armazenadas em cache. O eCDN não armazena em cache respostas HTML, JSON, XML ou TXT por padrão (exceto robots.txt). O tamanho máximo do objeto armazenável em cache é de 5 GB.

Uma resposta é armazenada em cache somente quando todas essas condições forem verdadeiras.

• O método de solicitação é GET.
• A resposta não tem cabeçalho Set-Cookie.
• A resposta tem Cache-Control: public with max-age > 0 ou uma data de expiração futura. Quando vários valores estão presentes, a precedência é s-maxage, em seguida, max-age e, em seguida, Expira.

Uma resposta não será armazenada em cache se qualquer uma dessas condições for verdadeira.

• Cache-Control é private, no-store, no-cache ou max-age=0.
• Nenhum cabeçalho Cache-Control está presente.
• Um cabeçalho Set-Cookie está presente.
• O método de solicitação não é GET.

Nota Uma regra de cache só qualifica um tipo de conteúdo que não pode ser armazenado em cache (HTML ou JSON). As regras de cabeçalho de origem ainda se aplicam.

Práticas recomendadas

• Cache HTML e JSON deliberadamente. Torne o conteúdo dinâmico elegível apenas quando a resposta for genuinamente compartilhada entre os compradores e segura para cache. Nunca armazene em cache respostas personalizadas ou autenticadas. Certifique-se de que essas respostas tenham Set-Cookie ou Cache-Control: private.
• Use tags de cache para invalidação coordenada. Carimbe o conteúdo relacionado com tags compartilhadas (por exemplo, por produto, categoria ou elemento de conteúdo) para que você possa limpar um grupo lógico em uma solicitação em vez de listar caminhos.
• Exclua parâmetros de rastreamento da chave de cache (por exemplo, gclid e utm_campaign) para maximizar a taxa de acertos do cache.
• Verifique o cache com o cabeçalho de resposta Cf-Cache-Status. Um valor de HIT confirma o cache de borda. Um valor de MISS ou DYNAMIC indica que o conteúdo não foi obtido do cache.
• Teste primeiro em uma área restrita. ODS As zonas padrão oferecem suporte a regras de cache e limpeza, portanto, você pode validar o comportamento da regra em uma área restrita antes de aplicá-la à produção.

Solução de problemas

O conteúdo não está armazenando em cache conforme o esperado? Confira, em ordem:

1. Cabeçalhos de origem — a resposta está enviando Cache-Control: public, max-age>0 (ou um futuro expira)?
2. Set-Cookie — um cabeçalho Set-Cookie suprime o cache. Removê-lo para respostas que podem ser armazenadas em cache.
3. Método de solicitação — somente GET é armazenado em cache.
4. Precisão da expressão — a expressão de regra realmente corresponde ao caminho/extensão da solicitação?
5. Regra habilitada? — confirme se o sinalizador Habilitado da regra está ativado.
6. Cabeçalho Cf-Cache-Status — HIT vs MISS/DYNAMIC informa se a borda é servida do cache.