# Limpar a cache do Kapsule CDN

Source: https://support.kapsulehost.com/pt-pt/cdn-cache-purge

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.

> **Tip:** 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

1. Inicie sessão no [KPanel](https://kpanel.kapsulehost.com).
2. Clique em **Sites** na barra lateral esquerda e, depois, no seu site.
3. No menu do site, abra **Desempenho** e depois **Kapsule CDN**.
4. Desloque-se até ao cartão **Limpar cache**.

O endereço direto é `/websites/<site-id>/cdn`.

![O cartão Limpar cache na página do Kapsule CDN](https://support.kapsulehost.com/help/screenshots/cdn-cache-purge.881b7fa3.webp)

> **Note:** 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](https://support.kapsulehost.com/pt-pt/cdn-enabling) indica exatamente que planos o incluem.

## Limpar um único URL

1. 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`.
2. Clique em **Limpar**.
3. 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

1. Deixe o campo **URL a limpar** completamente em branco.
2. Clique em **Limpar**.
3. A confirmação indica "Cache completo limpo."

> **Warning:** 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.

> **Tip:** 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](https://support.kapsulehost.com/pt-pt/website-speed) 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](mailto:support@kapsulehost.com) com o URL exato e a hora a que fez a limpeza.