Ativando Kapsule CDN no Seu Site

Kapsule CDN armazena o seu site na borda para que os visitantes em qualquer lugar do mundo sejam servidos de um local próximo em vez do seu servidor de origem, e ativá-lo é apenas um único botão no site que deseja acelerar.

Não há um produto CDN separado para comprar: ele vem com o plano de hospedagem em que o site está. Você o ativa no menu do próprio site em KPanel, espera alguns minutos para que o certificado de borda seja emitido, e seu domínio começa a ser servido pela nossa rede de borda. Duas coisas precisam ser verdadeiras primeiro, e este guia cobre ambas: o site precisa de um domínio personalizado, e seu plano precisa incluir o CDN.

O Que Kapsule CDN Faz

Quando o CDN está ativo, as requisições do seu domínio chegam primeiro à nossa rede de borda. Tudo que é armazenável em cache é respondido de um dos 119+ locais globais mais próximos. Tudo que não é armazenável em cache, ou que expirou, é buscado de seu servidor de origem e então retido na borda para o próximo visitante.

Quais Planos Incluem o CDN

O CDN é um direito do plano, então o que seu site obtém depende do plano em que ele está. Existem dois níveis, e o distintivo no topo da página do CDN diz qual está ativo:

• Kapsule CDN cobre cache de borda global, o certificado SSL de borda emitido automaticamente e limpeza de cache.
• Kapsule CDN+ adiciona proteção DDoS e roteamento inteligente de borda em cima disso, e tem uma alocação de largura de banda incluída maior.

Você pode comparar e mudar de planos em kpanel.kapsulehost.com/plans/hosting, ou veja Upgrading Your Plan.

Antes de Começar

O motivo é técnico e não comercial: a borda tem que emitir um certificado SSL para o nome do host que serve, e isso requer um nome de host cujo DNS possa ser apontado para a borda. Um nome de host Kapsule compartilhado é gerenciado por nós e não pode ser redirecionado para você, então a solicitação de certificado nunca seria concluída e o site pareceria estar ativado enquanto servia erros. Bloqueamos isso no ponto do clique. Veja Adding a Custom Domain to Your Website para as etapas de conexão.

Ativar o CDN Muda Seu DNS

Isso vale a pena entender antes de clicar, porque surpreende as pessoas.

Ativar o CDN não deixa seu DNS sozinho. Seu domínio tem que resolver para nossa rede de borda em vez de ir direto para sua origem, então ativar o CDN reescreve dois registros para o site:

• Um CNAME em www apontando para a borda. Qualquer registro A ou AAAA existente em www é removido primeiro, porque um CNAME não pode ficar ao lado deles.
• Um ALIAS no domínio nu apontando para a mesma borda, então o tráfego para seu domínio sem www também passa pelo CDN. Qualquer registro A ou AAAA no domínio nu é removido.

O site só é marcado como CDN-ativado uma vez que o DNS do domínio primário foi realmente escrito e apontado para a borda. Se essa etapa não for bem-sucedida, o painel continua mostrando o CDN como desativado em vez de lhe dizer que está ativado enquanto seu tráfego vai para outro lugar.

Como Ativar o CDN

1. Entre em KPanel.
2. Clique em Websites na barra lateral esquerda, depois clique no site que deseja acelerar.
3. No menu do próprio site, abra Performance, depois Kapsule CDN.
4. A página abre no banner CDN is off for this site. Clique em Enable CDN.
5. Uma confirmação aparece: "CDN provisioning queued. The edge cert can take up to 5 minutes."

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

Como a Espera Fica

Nada visível acontece nos primeiros minutos, e isso é esperado e não indica um problema. Aqui está a sequência:

1. Os registros DNS descritos acima são escritos para seu domínio.
2. Esses registros têm que se propagar antes que um certificado possa ser emitido para o nome do host. Essa é uma restrição de timing do DNS, não uma fila que possamos pular.
3. A borda solicita o certificado. Se o DNS ainda não se propagou, a solicitação é deixada pendente e repetida automaticamente até ter sucesso.
4. Uma vez que o certificado é emitido, o site muda para CDN-ativado.

Uma vez que o certificado é emitido, o banner muda para CDN is on com a nota "CDN active. Your domain serves content from the edge", e o conjunto completo de cartões de controle aparece abaixo. HTTPS é forçado no nome do host nesse ponto.

Configurações Que Você Pode Alterar

Cache TTLs

O cartão Cache TTLs contém dois números, ambos em segundos, ambos com padrão de 3600 (uma hora):

• Edge TTL (seconds): por quanto tempo a borda mantém uma cópia antes de voltar à sua origem.
• Browser TTL (seconds): por quanto tempo o próprio navegador de um visitante mantém sua cópia.

Números menores significam conteúdo mais fresco e mais requisições para sua origem. Números maiores significam melhor desempenho e conteúdo mais antigo até você fazer uma limpeza. As alterações são salvas conforme você as define e são enviadas para a borda imediatamente.

Otimização de Imagens

O cartão Image optimisation tem dois interruptores:

• On-the-fly image optimisation: redimensiona e comprime imagens na primeira requisição, depois armazena em cache o resultado otimizado na borda.
• Serve WebP to supported browsers: entrega WebP para navegadores que anunciam suporte, e o formato original para tudo mais.

Ambos valem a pena deixar ativados para quase todos os sites. Desative a otimização de imagens apenas se você servir imagens que devem chegar idênticas ao byte do original.

Monitorando Sua Largura de Banda

O cartão This month's bandwidth lê em tempo real da borda e é redefinido no primeiro de cada mês. Ele mostra o que você usou em relação à alocação incluída com seu plano, com uma barra que fica âmbar após 80 por cento e vermelha em 100 por cento.

Se o cartão ler "Usage unavailable", a figura ao vivo simplesmente não pôde ser obtida naquele momento. É um problema de exibição, não um sinal de que o CDN está inativo. Recarregue a página em um minuto.

Desativando o CDN

1. Abra Performance, depois Kapsule CDN no site.
2. Role até o cartão Disable CDN, que lê "Traffic goes back to your origin server."
3. Clique em Disable.

O tráfego reverte para sua origem imediatamente, e a zona de borda para o site é removida para que a largura de banda pare de se acumular. Você pode ativá-lo novamente a qualquer momento, mas os registros DNS e o certificado de borda têm que ser configurados novamente, então permita mais alguns minutos.

Resolução de Problemas

"Kapsule CDN needs a custom domain." O site ainda está em um nome de host Kapsule compartilhado. Conecte seu próprio domínio e depois ative o CDN nesse domínio. Essa é a razão individual mais comum para o botão falhar.

"Kapsule CDN is not included on your current plan." O plano anexado a este site não tem direito CDN. Projetos Kapsule Orbit e planos Container Hosting são os casos usuais. Mova o site para um dos planos listados acima e o botão fica disponível. Veja Upgrading Your Plan.

O banner ainda diz que o CDN está desativado após um minuto. Os registros DNS têm que se propagar antes que o certificado possa ser emitido, o que leva até cerca de cinco minutos. Espere e depois recarregue.

Passou muito mais de cinco minutos e o CDN ainda está desativado. A causa mais provável é que o DNS do seu domínio não está hospedado conosco, então os registros não puderam ser escritos automaticamente. Verifique para onde seus nameservers apontam. Se seu domínio está nos nameservers Kapsule e ainda está travado, entre em contato conosco.

Meu site voltou para a origem depois que editei o DNS. Re-adicionar um registro A em www ou no domínio nu sobrescreve os registros que roteiam o tráfego para a borda. Desative o CDN, organize o DNS que você precisa, depois ative-o novamente.

O distintivo do CDN está mostrando, mas minhas alterações não estão. Esse é o cache funcionando conforme projetado. Limpe a URL que você mudou, ou o site inteiro: veja Purging the Kapsule CDN Cache.

O site não ficou mais rápido. O CDN acelera a entrega, não a geração de página. Se suas páginas são lentas para construir na origem, armazene-as em cache por mais tempo ou corrija a origem primeiro. Improving Website Speed cobre o lado da origem.

Se o distintivo ainda não apareceu quinze minutos após ativar o CDN, envie-nos um email em support@kapsulehost.com com o domínio do site e analisaremos a emissão do certificado.