Limpar a cache remove a cópia do seu conteúdo guardada na edge, para que o visitante seguinte receba uma versão acabada de obter a partir da sua origem. É o que faz quando publicou uma alteração e a versão antiga continua a aparecer.
A cache é o que torna o CDN rápido, e é também a razão pela qual uma alteração que acabou de fazer pode não aparecer de imediato. Em vez de reduzir a zero a duração da cache, mantenha-a longa e limpe-a quando for preciso. Este guia aborda as duas coisas, bem como a forma de distinguir uma cache da edge de uma cache do navegador antes de procurar no sítio errado.
Quando precisa de limpar a cache
Limpe a cache depois de alterar algo que os visitantes obtêm através de um URL:
- Substituiu um ficheiro CSS ou JavaScript e o antigo continua a ser servido.
- Carregou uma nova versão de uma imagem por cima de um nome de ficheiro já existente.
- Corrigiu um erro numa página e quer que a versão com erro desapareça em todo o mundo, já.
- Alterou o conteúdo de uma página e não pode esperar que o TTL da edge expire.
Não precisa de limpar a cache quando adicionou uma página totalmente nova ou um novo nome de ficheiro. Nada está em cache para um URL que nunca foi pedido.
Se incluir uma versão nos nomes de ficheiro dos seus recursos (style.a1b2c3.css em vez de style.css), raramente terá de limpar a cache. Um novo nome de ficheiro é um novo URL, por isso é obtido de novo a partir da sua origem e guardado em cache com a sua própria chave.
Onde fica o controlo de limpeza
- Inicie sessão no KPanel.
- Clique em Sites na barra lateral esquerda e, depois, no seu site.
- No menu do site, abra Desempenho e depois Kapsule CDN.
- Desloque-se até ao cartão Limpar cache.
O endereço direto é /websites/<site-id>/cdn.
O controlo de limpeza só aparece quando o CDN está ativado para o site. Se a página mostrar o aviso CDN desativado para este site, ou lhe pedir para ligar um domínio personalizado, ainda não há nada para limpar na edge. Ativar o Kapsule CDN no seu site indica exatamente que planos o incluem.
Limpar um único URL
- No cartão Limpar cache, escreva o URL público completo no campo URL a limpar (deixe em branco para o site inteiro). O texto de exemplo do campo mostra a forma esperada:
https://your-domain.tld/path. - Clique em Limpar.
- Aparece uma confirmação a indicar que o URL que introduziu foi limpo.
Use o URL exato que um visitante pediria, incluindo o esquema (https://), o anfitrião e o caminho. A limpeza é associada ao URL, por isso https://example.com/about e https://example.com/about/ são duas entradas de cache diferentes, tal como a mesma página com uma query string acrescentada.
Limpar um único URL é o primeiro passo certo quando sabe exatamente o que mudou. É instantâneo e deixa o resto da cache intacto, para que o resto do site continue rápido.
Limpar o site inteiro
- Deixe o campo URL a limpar completamente em branco.
- Clique em Limpar.
- A confirmação indica "Cache completo limpo."
Uma limpeza completa esvazia todos os objetos em cache do site em todas as localizações da edge. Até cada URL voltar a ser pedido, todos os visitantes são servidos a partir da sua origem, pelo que a origem recebe um pico de tráfego e o primeiro visitante de cada página espera por uma viagem de ida e volta completa. Num site com muito tráfego, prefira limpar apenas os URL específicos que alterou.
Cada limpeza que executa fica registada no registo de atividade da conta com o URL ou uma marca de zona completa, para que possa ver quem limpou o quê e quando.
Duração da cache e como interagem
O cartão TTLs de Cache, na mesma página, controla quanto tempo o conteúdo se mantém sem uma limpeza:
| Definição | O que controla | Predefinição |
|---|---|---|
| TTL de Edge (segundos) | Quanto tempo a edge guarda uma cópia antes de a obter novamente da sua origem | 3600 (1 hora) |
| TTL do Navegador (segundos) | Quanto tempo o navegador de um visitante guarda a sua própria cópia local | 3600 (1 hora) |
Os dois são independentes, e esta é de longe a causa de confusão mais comum. Uma limpeza apaga a edge. Não consegue chegar ao navegador de um visitante. Se limpar a cache e continuar a ver a versão antiga, é quase certo que está a ver a cache do seu próprio navegador.
Para excluir essa hipótese, carregue a página numa janela privada ou anónima, ou faça um recarregamento forçado. Se a janela privada mostrar a nova versão, a limpeza funcionou e está apenas à espera do seu próprio navegador e dos navegadores dos outros visitantes, que serão atualizados quando o respetivo TTL do navegador expirar.
Se publica com frequência e não consegue incluir versões nos nomes de ficheiro, reduza o TTL do Navegador para um valor curto (alguns minutos) e deixe o TTL de Edge longo. Mantém a maior parte da vantagem da edge e dá aos visitantes uma janela muito mais curta em que podem ficar presos a uma cópia antiga.
Otimização de imagens e limpeza
Se a Otimização de imagens em tempo real estiver ativada (uma funcionalidade do Kapsule CDN+), a edge guarda a versão otimizada de cada imagem ao lado do original. Limpar o URL da imagem apaga também a versão otimizada, pelo que uma imagem substituída volta a ser otimizada no pedido seguinte. Não existe uma limpeza separada para imagens otimizadas.
O mesmo se aplica a Servir WebP para navegadores suportados: a variante WebP está sob o mesmo URL e é apagada pela mesma limpeza.
Resolução de problemas
"CDN não provisionado para este site." O site ainda não tem uma zona de edge. Ative primeiro o CDN e aguarde que o certificado termine de ser provisionado.
"Limpeza falhou." O pedido de limpeza não chegou à edge. Aguarde um momento e tente novamente. Se continuar a falhar, a zona de edge pode estar ainda a ser provisionada; confirme que a página mostra o aviso CDN ativado.
Limpei a cache e a página continua antiga. Verifique primeiro numa janela privada. Se uma janela privada também mostrar a versão antiga, confirme que limpou o URL exato, incluindo qualquer barra final e query string, e depois experimente uma limpeza completa.
Só alguns visitantes veem a atualização. Os navegadores deles ainda estão dentro do TTL do navegador. Não há nada de errado: vão receber a nova versão quando este expirar, ou de imediato com um recarregamento forçado.
A origem foi abaixo depois de uma limpeza completa. É o pico de tráfego sem cache descrito acima. Aumente o TTL da edge e, da próxima vez, limpe apenas os URL que mudaram. Melhorar a velocidade do website explica como tornar a própria origem mais resistente.
Se uma limpeza for bem-sucedida mas a edge continuar a servir conteúdo antigo durante mais do que alguns minutos, envie um e-mail para support@kapsulehost.com com o URL exato e a hora a que fez a limpeza.