CDN:Perguntas frequentes sobre atualização e pré-carregamento

Qual é a diferença entre atualização e pré-carregamento?

Atualização e pré-carregamento são duas operações distintas:

• Atualização: Instrui os nós de borda a marcar os recursos em cache como expirados. Quando um usuário solicita o recurso novamente, o nó de borda busca a versão mais recente na origem, entrega-a ao usuário e a armazena em cache novamente. Uma operação de atualização reduz temporariamente a taxa de acertos do cache.

• Pré-carregamento: Carrega proativamente os recursos do servidor de origem para os nós de borda. Quando um usuário solicita o recurso pela primeira vez, um nó de borda próximo o atende diretamente, eliminando a necessidade de buscar na origem. Uma operação de pré-carregamento aumenta a taxa de acertos do cache.

Existe uma ordem recomendada para atualização e pré-carregamento?

Atualização e pré-carregamento são operações independentes, sem uma ordem obrigatória. No entanto, ao atualizar um recurso no servidor de origem, recomendamos seguir esta sequência lógica:

• Atualize primeiro: Remova o conteúdo antigo do cache da CDN para garantir que as solicitações subsequentes recuperem a versão mais recente do servidor de origem.

• Em seguida, faça o pré-carregamento: Após a conclusão da tarefa de atualização, pré-carregue o conteúdo atualizado nos nós de borda. Isso garante que os usuários acessem o novo conteúdo com latência mínima.

• Primeira integração com a CDN: Se o conteúdo ainda não estiver em cache nos nós de borda, pré-carregue os recursos diretamente para aquecer o cache.

Devo usar a URL de origem ou a URL do domínio acelerado?

Use sempre a URL que contém o domínio acelerado, e não a URL do seu servidor de origem. O sistema do Alibaba Cloud CDN identifica e gerencia os recursos em cache pelo domínio acelerado. Enviar uma solicitação de atualização ou pré-carregamento para uma URL sob um domínio acelerado garante que o conteúdo em cache nos nós de borda seja atualizado ou pré-carregado corretamente.

Como atualizar o conteúdo em cache de um domínio curinga?

O Alibaba Cloud CDN não oferece suporte à atualização de todo o conteúdo em cache sob um domínio curinga em uma única operação. Envie solicitações de atualização separadas para subdomínios, diretórios ou caminhos de URL específicos. Não use padrões como https://*.example.com/file01.html ou https://*.example.com/file02/. Para atualizar várias URLs, insira uma URL por linha.

Quanto tempo levam as tarefas de atualização e pré-carregamento?

• Tarefa de atualização: Geralmente, propaga-se por toda a rede em cerca de 5 a 6 minutos. Se o TTL configurado de um recurso for menor que esse período, a atualização manual torna-se desnecessária.

• Tarefa de pré-carregamento: O tempo necessário depende do tamanho e da quantidade de arquivos, mas a conclusão costuma levar de 5 a 30 minutos.

Como aplicar alterações de configuração da CDN imediatamente?

Alterações nas configurações da CDN, como Host de origem, regras de cache ou cabeçalhos de resposta, normalmente se aplicam apenas a novas solicitações. Caso um nó de borda já tenha armazenado em cache cabeçalhos de resposta ou conteúdo antigos, ele não aplicará a nova configuração a esse conteúdo em cache. Para que as alterações tenham efeito imediato, atualize manualmente o cache das URLs ou diretórios correspondentes. Isso força os nós de borda a buscar na origem e recuperar o recurso com a nova configuração.

Por exemplo, após modificar um cabeçalho de resposta ou TTL, acesse a página Cache Refresh no console da CDN. Insira as URLs ou caminhos de diretório que deseja atualizar e envie a solicitação. Se uma alteração de configuração causar incompatibilidade de Content-Type, corrija primeiro os metadados no servidor de origem e, em seguida, atualize as URLs afetadas.

Posso incluir cabeçalhos personalizados nas solicitações de pré-carregamento?

Por padrão, as solicitações de pré-carregamento incluem o cabeçalho Accept-Encoding: gzip. Para incluir outros cabeçalhos em uma solicitação de pré-carregamento ou realizar um pré-carregamento de múltiplas réplicas, utilize a OpenAPI.

Como atualizar arquivos com o mesmo nome após configurar a CDN?

Siga estas práticas recomendadas ao atualizar arquivos acelerados pela CDN:

• Para atualizações gerais de arquivos, adicione um número de versão à URL do recurso, como ?v=1.0. Isso evita problemas de cache relacionados a atualizações de arquivos com o mesmo nome.

• Caso seja indispensável atualizar mantendo o mesmo nome, envie uma solicitação de atualização pelo console ou via OpenAPI. Para operações no console, consulte Atualizar e pré-carregar recursos. Para operações via OpenAPI, consulte Atualização e pré-carregamento.

Por que atualizar apenas a página inicial não basta para atualizações de JS/CSS?

Navegadores e a CDN armazenam em cache URLs específicas de arquivos JS e CSS. Se você atualizar o conteúdo de um arquivo sem alterar seu nome, ou se mudar o nome do arquivo mas não atualizar a referência no HTML, atualizar apenas a página inicial pode ser insuficiente. O navegador do usuário ou a CDN podem continuar servindo a versão antiga dos sub-recursos a partir do cache.

Recomendações:

• Atualize as URLs específicas dos arquivos JS/CSS, e não apenas a página inicial.

• Como prática recomendada, adicione parâmetros de versão às URLs dos recursos, como ?v=1.0, para evitar problemas de cache causados por atualizações com o mesmo nome.

• Se ocorrer uma atualização com o mesmo nome no servidor de origem, atualize manualmente o cache da URL correspondente no console da CDN. Aguarde alguns minutos após a conclusão da tarefa de atualização e teste novamente em uma janela anônima.

Por que o recurso não foi atualizado após a atualização e o pré-carregamento?

Possíveis causas: Esse cenário pode ocorrer por vários motivos:

• Embora a tarefa de atualização tenha limpado o cache da CDN, seu navegador ainda está servindo uma versão antiga do recurso a partir do cache local.

• O recurso no servidor de origem não foi atualizado.

• A tarefa de atualização ou pré-carregamento ainda não foi concluída.

• Ao executar uma atualização de diretório, a CDN marca os objetos como expirados por padrão. Durante a próxima busca na origem, a CDN inclui um cabeçalho If-Modified-Since ou If-None-Match na solicitação. Se o Last-Modified ou ETag do arquivo com o mesmo nome no servidor de origem não tiver sido alterado, o servidor de origem retorna um código de status 304 Not Modified, e a CDN continua servindo o conteúdo antigo.

Soluções: Experimente as seguintes soluções de acordo com a causa identificada:

• Limpe o cache do navegador e atualize a página para verificar se o recurso foi atualizado. Também é possível testar usando uma janela anônima ou outro navegador.

• Aponte seu domínio diretamente para o servidor de origem modificando o arquivo hosts local. Em seguida, acesse o servidor de origem diretamente para verificar se o recurso foi atualizado. Caso contrário, atualize o recurso no servidor de origem antes de acelerá-lo com a CDN.

• Verifique o status da tarefa na página Atualizar e pré-carregar recursos.

• Execute uma atualização de URL (tipo Arquivo) para excluir o cache de um arquivo específico. Alternativamente, chame a API RefreshObjectCaches e defina o parâmetro Force como true. Isso realiza uma atualização forçada, que exclui imediatamente o conteúdo dos nós de borda em vez de apenas marcá-lo como expirado.

Na página Purge and Prefetch, clique em Records. Verifique se o Status da tarefa é Completed e se o Progress está em 100% para confirmar a conclusão.

Por que a velocidade de download diminui durante o pré-carregamento?

Uma tarefa de pré-carregamento aciona downloads simultâneos do servidor de origem para vários nós de borda. A velocidade de download de um único nó pode ser rápida inicialmente, mas, à medida que mais nós iniciam o download, a velocidade geral fica limitada pela largura de banda do servidor de origem. Para servidores de origem com baixa largura de banda, as tarefas de pré-carregamento levarão mais tempo. Avalie a largura de banda da sua origem e aumente-a se necessário, ou divida grandes tarefas de pré-carregamento em lotes menores.

Como os redirecionamentos 30X do servidor de origem afetam o pré-carregamento?

Se o servidor de origem retornar um código de status 307 ou outro relacionado a redirecionamento durante o pré-carregamento, a tarefa não seguirá o redirecionamento e falhará. Se o servidor de origem retornar um código de status 301 ou 302 e você tiver ativado o Seguimento de redirecionamento 301/302 na CDN, a CDN seguirá o redirecionamento, permitindo que a tarefa de pré-carregamento seja concluída com êxito.

Como resolver conteúdo obsoleto ou erros 404 após excluir ou atualizar um arquivo na origem?

Os nós de borda da CDN podem ter uma versão antiga de um recurso em cache. Mesmo que o arquivo no servidor de origem tenha sido excluído ou atualizado, a versão em cache ainda pode ser servida. Para resolver isso:

1. Execute uma operação de atualização para a URL específica no console da CDN ou usando a API.

2. Se o problema for causado por uma política de cache no nível de diretório, atualize todo o diretório. Para garantir que o conteúdo seja completamente removido, chame a API RefreshObjectCaches e defina o parâmetro Force como true para realizar uma atualização forçada.

3. Confirme se o arquivo foi realmente atualizado ou excluído no servidor de origem.

Como solucionar falhas de pré-carregamento?

Se uma tarefa de pré-carregamento falhar, verifique os seguintes itens:

1. Verifique a acessibilidade da URL: Confirme se a URL que você deseja pré-carregar está acessível em um navegador e retorna um código de status 200. Se retornar um código de status 308 ou outro de redirecionamento, faça o pré-carregamento da URL correta que termina com barra (/).

2. Certifique-se de não estar pré-carregando um diretório: O pré-carregamento é suportado apenas para URLs de arquivos específicos, não para caminhos de diretório que terminam com /.

3. Verifique conflitos com a aceleração dinâmica do OSS: Se sua origem for um bucket do OSS e você tiver ativado a aceleração dinâmica, arquivos estáticos podem ignorar o caminho de cache. Desative a aceleração dinâmica ou especifique os tipos de arquivo estático a serem armazenados em cache.

4. Verifique o formato da URL: As URLs devem começar com um cabeçalho de protocolo completo (http:// ou https://) e não devem conter caracteres ilegais, como caracteres de largura total ou espaços extras. Separe várias URLs com quebras de linha, não com vírgulas.

5. Verifique se o recurso pode ser armazenado em cache: Garanta que o recurso que você deseja pré-carregar não possua cabeçalhos como Cache-Control: no-cache/no-store/private, que impedem o armazenamento em cache.

Preciso atualizar e pré-carregar separadamente para HTTP e HTTPS?

Não. O Alibaba Cloud CDN trata as versões HTTP e HTTPS de uma URL como o mesmo recurso para fins de cache. Uma solicitação de atualização ou pré-carregamento para um protocolo aplica-se a ambos. Por exemplo, se você precisar pré-carregar o arquivo aaa.mp4, basta pré-carregar https://example.com/aaa.mp4. Não é necessário pré-carregar também http://example.com/aaa.mp4.