CDN
Limpando o cache do Kapsule CDN
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
Limpando o Cache de Kapsule CDN
Limpar remove a cópia do seu conteúdo armazenada na borda para que o próximo visitante obtenha uma versão recém-obtida da sua origem, o que você faz quando publicou uma alteração e a versão antiga ainda está sendo exibida.
O cache é o que torna a CDN rápida, e também é a razão pela qual uma alteração que você acabou de fazer pode não aparecer imediatamente. Em vez de reduzir os tempos de vida do cache a zero, mantenha-os longos e limpe sob demanda. Este guia aborda ambos, além de como diferenciar um cache de borda de um cache do navegador antes de procurar no lugar errado.
Quando Você Precisa Limpar
Limpe depois de ter alterado algo que os visitantes obtêm por URL:
- Você substituiu um arquivo CSS ou JavaScript e o antigo ainda está sendo servido.
- Você carregou uma nova versão de uma imagem sobre um nome de arquivo existente.
- Você corrigiu um bug em uma página e quer que a versão quebrada desapareça globalmente, agora mesmo.
- Você alterou o conteúdo de uma página e não pode esperar pelo TTL da borda expirar.
Você não precisa limpar quando adicionou uma página completamente nova ou um novo nome de arquivo. Nada é armazenado em cache para uma URL que nunca foi solicitada.
Se você versionar seus nomes de arquivo de assets (style.a1b2c3.css em vez de style.css), você raramente precisa limpar. Um novo nome de arquivo é uma nova URL, então é obtida fresca da sua origem e armazenada em cache sob sua própria chave.
Onde o Controle de Limpeza se Encontra
- Faça login em KPanel.
- Clique em Websites na barra lateral esquerda e depois clique no seu site.
- No menu do site, abra Performance e depois Kapsule CDN.
- Role até o card Purge cache.
O endereço direto é /websites/<site-id>/cdn.
O controle de limpeza aparece apenas quando a CDN está ativada para o site. Se a página exibir o banner CDN is off for this site ou pedir que você conecte um domínio personalizado, não há nada na borda para limpar ainda. Kapsule CDN também é um direito do plano, então um site em um plano Kapsule Orbit ou Container Hosting não tem CDN. Enabling Kapsule CDN on Your Site lista exatamente quais planos a incluem.
Limpando uma URL Única
- No card Purge cache, digite a URL pública completa em URL to purge (leave blank for whole site). O placeholder do campo mostra a forma esperada:
https://your-domain.tld/path. - Clique em Purge.
- Uma confirmação aparece lendo "Purged" seguida da URL que você inseriu.
Use a URL exata que um visitante solicitaria, incluindo o esquema (https://), o host e o caminho. Uma limpeza é correspondida na URL, portanto https://example.com/about e https://example.com/about/ são duas entradas de cache diferentes, assim como a mesma página com uma query string anexada.
Limpar uma URL é o primeiro movimento certo quando você sabe exatamente o que mudou. É instantâneo e deixa o resto do seu cache intacto, então o resto do site permanece rápido.
Limpando o Site Inteiro
- Deixe o campo URL to purge completamente em branco.
- Clique em Purge.
- A confirmação lê "Full cache purged."
Uma limpeza completa esvazia todos os objetos em cache do site em todos os locais de borda. Até que cada URL seja solicitada novamente, cada visitante é servido pela sua origem, portanto a origem sofre um surto de tráfego e o primeiro visitante de cada página espera por uma viagem completa. Em um site ocupado, prefira limpar as URLs específicas que você alterou.
Cada limpeza que você executa é registrada no log de atividades da conta com a URL ou um marcador de zona completa, para que você possa ver quem limpou o quê e quando.
Tempos de Vida do Cache e Como Interagem
O card Cache TTLs, na mesma página, controla quanto tempo o conteúdo sobrevive sem uma limpeza:
| Configuração | O que controla | Padrão |
|---|---|---|
| Edge TTL (seconds) | Quanto tempo a borda mantém uma cópia antes de re-obter da sua origem | 3600 (1 hora) |
| Browser TTL (seconds) | Quanto tempo o navegador de um visitante mantém sua própria cópia local | 3600 (1 hora) |
Os dois são independentes, e esta é a fonte singular mais comum de confusão. Uma limpeza apaga o edge. Ela não pode alcançar o navegador de um visitante. Se você limpar e ainda vir a versão antiga você mesmo, você está quase certamente olhando para seu próprio cache do navegador.
Para descartar isso, carregue a página em uma janela privada ou incógnita, ou faça um recarregamento forçado. Se a janela privada mostra a versão nova, a limpeza funcionou e você está apenas esperando pelo seu próprio navegador e pelos navegadores de outros visitantes, que atualizarão assim que seu browser TTL expirar.
Se você publica com frequência e não pode versionar nomes de arquivo, reduza o Browser TTL para algo breve (alguns minutos) e deixe o Edge TTL longo. Você mantém a maioria do benefício de borda enquanto dá aos visitantes uma janela muito mais curta em que eles podem ficar presos em uma cópia antiga.
Otimização de Imagem e Limpeza
Se a On-the-fly image optimisation está ativada, a borda armazena o derivado otimizado de cada imagem junto ao original. Limpar a URL da imagem também remove o derivado, portanto uma imagem substituída é re-otimizada em sua próxima solicitação. Não há limpeza separada para imagens otimizadas.
O mesmo se aplica ao Serve WebP to supported browsers: a variante WebP vive sob a mesma URL e é apagada pela mesma limpeza.
Solução de Problemas
"CDN not provisioned for this site." O site não tem zona de borda ainda. Ative a CDN primeiro e espere o certificado terminar de ser provisionado.
"Purge failed." A solicitação de limpeza não alcançou a borda. Aguarde um momento e tente novamente. Se continuar falhando, a zona de borda pode estar em provisionamento; confirme que a página mostra o banner CDN is on.
Limpei e a página ainda é antiga. Verifique primeiro em uma janela privada. Se uma janela privada também mostra a versão antiga, confirme que você limpou a URL exata, incluindo qualquer barra final e query string, depois tente uma limpeza completa.
Apenas alguns visitantes veem a atualização. Seus navegadores ainda estão dentro do browser TTL. Nada está errado: eles pegarão a versão nova quando isso expirar, ou imediatamente em um recarregamento forçado.
A origem caiu após uma limpeza completa. Este é o surto de tráfego sem cache descrito acima. Aumente o edge TTL e da próxima vez limpe apenas as URLs que mudaram. Improving Website Speed aborda tornar a própria origem mais resiliente.
Se uma limpeza é bem-sucedida mas a borda continua servindo conteúdo antigo por mais de alguns minutos, envie um email para support@kapsulehost.com com a URL exata e a hora em que você limpou.