CDN:Limpeza e pré-busca de recursos

Limpeza de recursos

Uma operação de limpeza envia um comando de invalidação de cache para os nós de borda em vez de excluir arquivos diretamente. Quando um nó de borda recebe o comando, ele marca os recursos em cache correspondentes como "inválidos" ou "expirados". Na próxima vez que um usuário solicitar o recurso, o nó de borda detectará que o cache é inválido, realizará uma busca na origem para recuperar a versão mais recente e a entregará ao usuário, armazenando a nova versão em cache.

Método de limpeza padrão no console: Ao realizar uma limpeza de diretório ou uma limpeza baseada em expressão regular no console do CDN, o sistema usa uma limpeza suave por padrão. A limpeza suave apenas marca o cache como expirado. Quando o nó de borda realiza uma busca na origem, ele inclui um cabeçalho If-Modified-Since ou If-None-Match na solicitação. Se o servidor de origem retornar uma resposta 304 Not Modified, o nó de borda manterá a cópia antiga em cache. Esse método economiza tráfego de busca na origem, mas pode fazer com que os usuários acessem conteúdo desatualizado em cenários como atualizações de arquivos com o mesmo nome, remoção de conteúdo não compatível ou após alterações de configuração. Para limpar completamente o cache, recomendamos chamar a operação de API {{XREF_0}} e definir o parâmetro Force como true para realizar uma limpeza forçada.

Casos de uso

• Atualizações e lançamentos de recursos: Após atualizar os recursos no seu servidor de origem, envie as URLs ou diretórios correspondentes para limpeza para garantir que os usuários possam acessar o conteúdo mais recente, que será então armazenado em cache nos nós de borda.

• Remoção de recursos não compatíveis: Se o seu site tiver conteúdo não compatível, simplesmente excluí-lo do servidor de origem não é suficiente, pois ele ainda pode existir no cache dos nós de borda. Você deve realizar uma limpeza de URL para limpar os recursos em cache e garantir que o conteúdo não compatível seja removido rapidamente.

Pré-busca de recursos

Uma operação de pré-busca é um mecanismo baseado em pull que faz com que os nós de borda busquem proativamente os recursos do seu servidor de origem e os armazenem em cache. Não se trata de um push do servidor de origem. A pré-busca melhora a velocidade de acesso inicial para novos recursos ou páginas de eventos e reduz a pressão de busca na origem durante o lançamento de produtos ou eventos, protegendo assim o seu servidor de origem.

Mecanismo de pré-busca: Por padrão, uma operação de pré-busca armazena recursos em cache nos nós de busca na origem de Nível 2 (a camada de cache L2) em vez de distribuí-los para todos os nós de borda L1. Quando um usuário acessa um recurso pela primeira vez, o nó de borda L1 puxa o conteúdo de um nó de busca na origem de Nível 2 ou do servidor de origem e o armazena em cache. Portanto, a pré-busca reduz principalmente a carga no seu servidor de origem. A cobertura abrangente de cache nos nós de borda L1 depende dos padrões reais de acesso do usuário. Somente após a solicitação de um usuário acionar um nó L1 para armazenar o conteúdo localmente, os usuários subsequentes na mesma região poderão se beneficiar de um acerto de cache direto desse nó L1.

Casos de uso

• Configuração inicial do CDN: Após adicionar seu domínio ao CDN, faça a pré-busca de recursos estáticos populares para os nós de borda. Quando os usuários solicitarem esses recursos, os nós de borda poderão responder diretamente, o que elimina tempos de carregamento inicial lentos e melhora a experiência do usuário.

• Lançamento de eventos promocionais: Antes de um grande evento, faça a pré-busca de todos os recursos estáticos das páginas do evento. Quando o evento começar, todos os recursos estáticos já estarão em cache nos nós de borda e poderão ser entregues diretamente, garantindo tempos rápidos de carregamento da página.

• Lançamento de pacotes de instalação ou arquivos grandes: Antes de lançar uma nova versão ou um pacote de atualização, faça a pré-busca dos recursos para os nós de borda. Depois que o produto for ao ar, os nós de borda atendem às solicitações de download diretamente, o que melhora as velocidades de download e reduz a carga no seu servidor de origem.

Hierarquia de cache de pré-busca e resultados esperados

Uma operação de pré-busca armazena recursos em cache principalmente nos nós de agregação L2, e não em todos os nós de borda L1 (POPs). Quando um usuário solicita um recurso pré-buscado pela primeira vez, o POP L1 o recupera do nó L2 ou do servidor de origem. Portanto, o objetivo principal da pré-busca é reduzir a pressão no servidor de origem, e não garantir acertos de cache imediatos em todos os POPs L1.

• Avaliação de custos: A pré-busca ajuda a melhorar as taxas de acerto de cache. No entanto, para arquivos pequenos ou recursos não populares, avalie cuidadosamente o custo da pré-busca. A pré-busca gera tráfego de busca na origem, que é aproximadamente igual ao tamanho do arquivo multiplicado pelo número de nós L2.

Limpar recursos

1. Faça login no CDN console.

2. No painel de navegação à esquerda, clique em Purge and Prefetch.

3. Na aba Purge/Prefetch, selecione Purge como o tipo de operação.

4. Selecione um tipo de limpeza e envie a tarefa.

Como limpar um site inteiro (limpeza de site completo ou limpeza de diretório raiz)

O CDN não oferece uma opção de limpeza de site completo com um clique, mas você pode fazer isso através dos seguintes métodos:

1. Limpeza de diretório: Selecione Directory como o método de limpeza e insira a URL do diretório raiz do seu nome de domínio (por exemplo, https://<accelerated domain name>/). A URL deve terminar com uma barra (/).

2. Limpeza forçada (API): Se alguns POPs ainda entregarem conteúdo desatualizado após uma limpeza de diretório, chame a {{XREF_7}} (RefreshObjectCaches) e defina o parâmetro Force como true. Uma limpeza forçada remove incondicionalmente os recursos em cache de todos os POPs, forçando uma busca na origem na próxima solicitação.

   Nota

   O parâmetro Force não está disponível no formulário de limpeza do console. Para realizar uma limpeza forçada, use a API ou o SDK.

3. Clique em Submit para iniciar a tarefa de limpeza.

   • Após o envio, uma tarefa de limpeza não pode ser cancelada.

   • Uma tarefa de limpeza geralmente leva de 5 a 6 minutos para se propagar por toda a rede. Se um recurso em cache tiver um tempo de expiração menor que esse, você não precisa limpá-lo manualmente.

   • Se você ativar a limpeza de {{XREF_8}} no console do OSS, não poderá visualizar as tarefas de limpeza automática iniciadas a partir do OSS no console do CDN.

Fazer pré-busca de recursos

1. Faça login no CDN console.

2. No painel de navegação à esquerda, clique em Purge and Prefetch.

3. Na aba Purge/Prefetch, selecione Prefetch como o tipo de operação.

4. Na caixa de entrada de URL, insira as URLs completas dos arquivos para pré-busca, uma por linha. A pré-busca de diretório não é suportada. Exemplo: https://<accelerated domain name>/install/package.zip.

5. Clique em Submit para iniciar a tarefa de pré-busca.

   • Após o envio, uma tarefa de pré-busca não pode ser cancelada.

   • O tempo de conclusão de uma tarefa de pré-busca depende do tamanho do arquivo, do número de arquivos e do desempenho do servidor de origem. Geralmente leva de 5 a 30 minutos.

Notas sobre a pré-busca de arquivos do OSS

Quando seu servidor de origem for o OSS, observe os seguintes requisitos de URL:

• Formato de URL: Você deve inserir a URL completa do nome de domínio acelerado pelo CDN (por exemplo, https://cdn.example.com/path/file.zip). Não insira a URL do endpoint interno ou público do bucket do OSS (por exemplo, https://<Origin Domain Name>/...).

• Parâmetros de assinatura: As URLs de pré-busca não devem conter parâmetros de assinatura temporária do OSS, como Expires, OSSAccessKeyId ou Signature. Esses são parâmetros de autorização temporária que fazem com que as tarefas de pré-busca falhem.

• Código de status de resposta do servidor de origem: Uma tarefa de pré-busca requer um código de status 200 do servidor de origem. Se o servidor de origem retornar um redirecionamento 308 ou qualquer código de status diferente de 200, a tarefa de pré-busca falhará. Por exemplo, se a falta de uma barra no final da URL causar um redirecionamento, adicione a barra e reenvie a tarefa.

Automatizar tarefas de limpeza ou pré-busca

Recomendamos que você {{XREF_9}} nas seguintes situações:

• Você não tem desenvolvedores para automatizar tarefas e enviá-las manualmente resulta em altos custos operacionais.

• Você tem muitas URLs para limpar ou fazer pré-busca, e enviá-las em lotes é ineficiente.

• Você precisa verificar manual ou programaticamente se as tarefas de limpeza e pré-busca estão sendo executadas conforme o esperado.

Limpeza suave (política padrão do CDN)

• Caso de uso: Atualizações de conteúdo de rotina, como a publicação de novas versões de arquivos estáticos.

• Mecanismo: Este é o comportamento padrão para limpezas de diretório e baseadas em expressão regular enviadas através do console. Quando um nó de borda do CDN realiza uma busca na origem, ele inclui um cabeçalho If-Modified-Since ou If-None-Match na solicitação. O servidor de origem usa esses cabeçalhos para determinar se o recurso foi atualizado.

• Efeito: Se o recurso no servidor de origem não tiver mudado, o servidor de origem retornará um código de status 304 Not Modified. O nó de borda do CDN então continuará a entregar a cópia antiga em cache, o que não consome tráfego de busca na origem. Este é um método otimizado que economiza custos e reduz a carga no servidor de origem. Nota: Se você precisar limpar completamente o cache (por exemplo, para remover conteúdo não compatível, aplicar alterações de configuração ou atualizar um arquivo com o mesmo nome), uma limpeza suave pode não atender às suas necessidades. Nesses casos, use uma limpeza forçada.

Limpeza forçada

• Casos de uso: Remoção urgente de recursos não compatíveis ou incorretos, forçando uma atualização em toda a rede após corrigir configurações incorretas do cabeçalho de resposta Cache-Control, ou atualizando um arquivo no servidor de origem que possui o mesmo nome.

• Mecanismo: Para acionar uma limpeza forçada, defina o parâmetro Force como true ao chamar a operação de API {{XREF_14}}. Neste modo, o nó de borda do CDN marca incondicionalmente o recurso em cache como inválido e não realiza uma verificação de validação 304.

• Efeito: Na próxima solicitação do recurso, o nó de borda do CDN deve realizar uma busca na origem para obter a nova versão, mesmo que o arquivo no servidor de origem não tenha mudado.

Exemplo de parâmetro de limpeza forçada por API:

{
  "ObjectType": "Directory",
  "ObjectPath": "https://<accelerated domain name>/static/",
  "Force": true
}

Descrições dos parâmetros principais:

• ObjectType: Especifique Directory ou File.

• ObjectPath: Especifique o caminho completo do diretório terminando com /, ou uma URL de arquivo específica.

• Force: Defina como true para ativar a limpeza forçada. Isso limpa o cache diretamente, contornando a validação If-Modified-Since/If-None-Match do servidor de origem.

Casos de uso típicos para limpeza forçada

Recomendamos que você use a limpeza forçada (chamando a {{XREF_15}} e definindo Force=true) nos seguintes cenários:

• Remoção de conteúdo não compatível ou malware: Após excluir arquivos maliciosos do servidor de origem, você deve usar uma limpeza forçada ou garantir que o servidor de origem retorne o código de status HTTP correto (como 404) para a URL excluída. Caso contrário, os POPs podem continuar a entregar conteúdo não compatível do cache após uma revalidação padrão.

• Atualizações de arquivos com o mesmo nome (alterações de configuração): Se você substituir um arquivo no servidor de origem por uma nova versão usando o mesmo nome de arquivo, uma revalidação pode retornar um código de status 304 Not Modified e continuar entregando o conteúdo antigo em cache. Use uma limpeza forçada para garantir que o conteúdo mais recente seja entregue em todos os POPs.

• Problemas de exibição de página ou loops na página inicial: Se outras páginas do seu site continuarem mostrando a página inicial ou se as imagens forem exibidas incorretamente, e a limpeza de URL não resolver o problema, use uma limpeza de diretório com Force=true através da API.