CDN:Limpar e pré-carregar recursos

Limpeza de recursos

A operação de limpeza envia um comando de invalidação de cache aos nós de borda, em vez de excluir arquivos diretamente. Ao receber esse comando, o nó de borda marca os recursos correspondentes em cache como "inválidos" ou "expirados". Na próxima solicitação do usuário, o nó detecta que o cache está inválido, busca a versão mais recente na origem e a entrega ao usuário, armazenando simultaneamente a nova versão em cache.

Método padrão de limpeza no console: Ao executar uma limpeza de diretório ou baseada em expressão regular no console CDN, o sistema usa a limpeza suave por padrão. Esse método apenas marca o cache como expirado. Quando o nó de borda busca a 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 mantém a cópia antiga em cache. Embora essa abordagem economize tráfego de retorno à origem, ela pode fazer com que os usuários acessem conteúdo desatualizado em situações como atualizações de arquivos com o mesmo nome, remoção de conteúdo não conforme ou após mudanças de configuração. Para limpar completamente o cache, recomendamos chamar a operação da API purgeObjectCaches e definir o parâmetro Force como true para executar uma limpeza forçada.

Casos de uso

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

• Remoção de recursos não conformes: Caso seu site contenha conteúdo inadequado, excluí-lo apenas do servidor de origem não é suficiente, pois ele ainda pode permanecer no cache dos nós de borda. Realize uma limpeza de URL para remover os recursos em cache e assegurar a eliminação imediata do conteúdo não conforme.

Pré-carregamento de recursos

O pré-carregamento é um mecanismo baseado em pull que faz com que os nós de borda busquem proativamente recursos no servidor de origem e os armazenem em cache. Não se trata de um push vindo da origem. Essa técnica melhora a velocidade de acesso inicial para novos recursos ou páginas de eventos e reduz a pressão de buscas na origem durante lançamentos de products ou campanhas, protegendo assim o seu servidor.

Mecanismo de pré-carregamento: Por padrão, essa operação armazena recursos nos nós de retorno à origem de Nível 2 (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 Nível 2 ou diretamente da origem e o coloca em cache. Portanto, o objetivo principal do pré-carregamento é reduzir a carga no servidor de origem. A cobertura completa de cache nos nós L1 depende dos padrões reais de acesso dos usuários. Somente após uma solicitação acionar o armazenamento local no nó L1 é que os usuários subsequentes na mesma região poderão se beneficiar de um acerto direto de cache nesse nó.

Casos de uso

• Configuração inicial da CDN: Depois de adicionar seu domínio à CDN, pré-carregue recursos estáticos populares nos nós de borda. Assim, quando os usuários solicitarem esses arquivos, os nós responderão diretamente, eliminando lentidão no carregamento inicial e melhorando a experiência do usuário.

• Lançamento de eventos promocionais: Antes de uma grande campanha, pré-carregue todos os recursos estáticos das páginas do evento. Quando a promoção começar, todo o conteúdo já estará em cache nos nós de borda e poderá ser servido imediatamente, garantindo tempos rápidos de carregamento.

• Disponibilização de pacotes de instalação ou arquivos grandes: Antes de lançar uma nova versão ou pacote de atualização, pré-carregue os recursos nos nós de borda. Após a ativação do product, os nós atenderão às solicitações de download diretamente, aumentando a velocidade de transferência e aliviando a carga no servidor de origem.

Hierarquia de cache do pré-carregamento e resultados esperados

Essa operação armazena recursos principalmente nos nós de agregação L2, e não em todos os nós de borda L1 (POPs). Na primeira solicitação de um recurso pré-carregado, o POP L1 o recupera do nó L2 ou da origem. Logo, a finalidade primordial é diminuir a pressão sobre o servidor de origem, e não garantir acertos imediatos de cache em todos os POPs L1.

• Avaliação de custos: O pré-carregamento ajuda a aumentar as taxas de acerto de cache. No entanto, para arquivos pequenos ou recursos pouco acessados, avalie cuidadosamente o custo envolvido. Essa operação gera tráfego de retorno à origem, cujo volume equivale aproximadamente ao tamanho do arquivo multiplicado pelo número de nós L2.

Limpar recursos

1. Faça login no console CDN.

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

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

4. Escolha o tipo de limpeza e envie a tarefa.

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

A CDN não oferece uma opção de limpeza de site completo com um clique, mas você pode alcançar esse resultado pelos métodos abaixo:

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

2. Limpeza forçada (API): Se alguns POPs continuarem servindo conteúdo desatualizado após uma limpeza de diretório, chame a API de Limpeza de Cache (RefreshObjectCaches) e defina o parâmetro Force como true. A 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 executar uma limpeza forçada, utilize a API ou o SDK.

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

   • Após o envio, não é possível cancelar uma tarefa de limpeza.

   • Geralmente, leva de 5 a 6 minutos para que a limpeza se propague por toda a rede. Se um recurso em cache tiver tempo de expiração inferior a esse período, a limpeza manual é desnecessária.

   • Se você ativar a limpeza automática de cache da CDN no console OSS, não será possível visualizar no console CDN as tarefas automáticas iniciadas a partir do OSS.

Pré-carregar recursos

1. Faça login no console CDN.

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

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

4. Na caixa de entrada de URL, insira as URLs completas dos arquivos a serem pré-carregados, uma por linha. O pré-carregamento de diretórios não é suportado. Exemplo: https://www.example.com/install/package.zip.

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

   • Não é possível cancelar uma tarefa de pré-carregamento após o envio.

   • O tempo de conclusão varia conforme o tamanho do arquivo, a quantidade de arquivos e o desempenho do servidor de origem. Normalmente, leva entre 5 e 30 minutos.

Observações sobre o pré-carregamento de arquivos do OSS

Quando o servidor de origem for o OSS, atente-se aos seguintes requisitos de URL:

• Formato de URL: Insira a URL completa do nome de domínio acelerado pela CDN (por exemplo, https://cdn.example.com/path/file.zip). Não utilize a URL de endpoint interno ou público do bucket OSS (como https://examplebucket.oss-cn-hangzhou.aliyuncs.com/...).

• Parâmetros de assinatura: As URLs de pré-carregamento não devem conter parâmetros de assinatura temporária do OSS, como Expires, OSSAccessKeyId ou Signature. Esses parâmetros de autorização temporária causam falha nas tarefas.

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

Automatizar tarefas de limpeza ou pré-carregamento

Recomendamos usar um script automatizado para limpar e pré-carregar recursos nas seguintes situações:

• Ausência de equipe de desenvolvimento para automação, tornando o envio manual custoso operacionalmente.

• Volume excessivo de URLs para limpeza ou pré-carregamento, tornando ineficiente o envio em lotes manuais.

• Necessidade de verificar manual ou programaticamente se as tarefas estão sendo executadas conforme o esperado.

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

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

• Mecanismo: Comportamento padrão para limpezas de diretório e regex enviadas pelo console. Ao buscar na origem, o nó de borda inclui o cabeçalho If-Modified-Since ou If-None-Match na solicitação. A origem usa esses cabeçalhos para verificar se houve atualização.

• Efeito: Se o recurso na origem não mudou, ela retorna o status 304 Not Modified. O nó de borda continua servindo a cópia antiga em cache, sem consumir tráfego de retorno à origem. É um método otimizado que economiza custos e reduz a carga na origem. Nota: Se for necessário limpar completamente o cache (ex.: remover conteúdo não conforme, aplicar mudanças de configuração ou atualizar arquivo com o mesmo nome), a limpeza suave pode não atender. Nesses casos, use a limpeza forçada.

Limpeza forçada

• Casos de uso: Remoção urgente de recursos não conformes ou errôneos, forçar atualização em toda a rede após corrigir configurações incorretas do cabeçalho de resposta Cache-Control, ou atualizar arquivo com o mesmo nome na origem.

• Mecanismo: Para acionar a limpeza forçada, defina o parâmetro Force como true ao chamar a operação da API RefreshObjectCaches. Nesse modo, o nó de borda marca incondicionalmente o recurso em cache como inválido, sem realizar a verificação 304.

• Efeito: Na próxima solicitação, o nó de borda fará uma busca na origem para obter a nova versão, mesmo que o arquivo na origem não tenha sido alterado.

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

{
  "ObjectType": "Directory",
  "ObjectPath": "https://www.example.com/static/",
  "Force": true
}

Descrição dos principais parâmetros:

• ObjectType: Especifique Directory ou File.

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

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

Casos típicos para limpeza forçada

Recomendamos usar a limpeza forçada (chamando a API de Limpeza de Cache e definindo Force=true) nos seguintes cenários:

• Remoção de conteúdo não conforme ou malware: Após excluir arquivos maliciosos da origem, use a limpeza forçada ou garanta que a origem retorne o código de status HTTP correto (como 404) para a URL excluída. Caso contrário, os POPs podem continuar servindo conteúdo inadequado do cache após uma revalidação padrão.

• Atualizações de arquivos com o mesmo nome (mudanças de configuração): Se substituir um arquivo na origem por uma nova versão mantendo o mesmo nome, a revalidação pode retornar status 304 Not Modified e continuar servindo o conteúdo antigo. Use a limpeza forçada para garantir a entrega do conteúdo mais recente em todos os POPs.

• Problemas de exibição de página ou loops na homepage: Se outras páginas do site continuarem mostrando a homepage ou imagens forem exibidas incorretamente, e a limpeza de URL não resolver, utilize a limpeza de diretório com Force=true via API.