Saltar para o conteúdo

Configurar a origem

A origem é onde o teu site vive de verdade. Este guia explica como a apontar, como ter mais do que uma, e o que fazemos quando ela deixa de responder.

Intermédio6 min de leitura

O que é a origem

O servidor onde o teu site está alojado. Pode ser uma máquina tua, um alojamento partilhado, um serviço de nuvem — para nós é um endereço a que vamos pedir páginas.

Cada pedido que não está em cache segue este caminho:

visitante → nós (edge mais próximo) → a tua origem → nós → visitante

Se a origem for lenta, tudo o que não está em cache é lento. Se a origem cair, servimos o que temos em cache e falha o resto.

Apontar a origem

Em Site → Servidores → Origem, o endereço aceita:

  • Um IP: 203.0.113.42
  • Um nome: servidor.oquefor.pt
  • Com esquema e porta: https://servidor.oquefor.pt:8443

HTTP ou HTTPS?

Usa HTTPS se a origem o suportar. O visitante fala HTTPS connosco de qualquer maneira, mas a ligação entre nós e a origem é uma segunda viagem — e essa viagem atravessa a internet.

Portas

Aceitamos as portas normais de web (80, 443) e um conjunto de portas alternativas comuns. Uma porta fora desse conjunto é recusada de propósito: um endereço de origem é um sítio a que a plataforma se liga, e uma lista aberta de portas transformava-o num scanner.

O que não aceitamos, e porquê

Endereços privados (10.x, 192.168.x, 172.16–31.x, 127.x, localhost). Os nossos servidores estão na internet: um 192.168.1.10 para nós não é a tua rede, é o que estiver naquele endereço dentro da nossa. Recusar isto é o que impede um endereço de origem de virar uma sonda à rede interna da plataforma.

A própria plataforma. Se a origem apontar para um nome que nós servimos, o pedido volta a entrar por aqui e nunca chega a nenhum servidor teu — dá uma volta infinita. Detectamos e recusamos ao guardar.

Mais do que uma origem

Podes acrescentar várias. A primeira activa é a primária; as outras entram quando ela deixa de responder.

A ordem importa e é tua: a lista é percorrida de cima para baixo.

Verificações de saúde

Se ligares as verificações, testamos a origem periodicamente e deixamos de lhe mandar tráfego enquanto ela estiver a falhar.

O que se configura:

CampoO que decide
CaminhoO que pedimos. / serve; um caminho leve dedicado (/health) serve melhor.
IntervaloDe quanto em quanto tempo testamos.
Falhas para marcar como doenteQuantas falhas seguidas antes de a tirarmos do serviço.
Sucessos para a devolverQuantas respostas boas antes de voltar.

Duas notas que poupam surpresas:

  • O caminho da verificação tem de responder sem sessão. Se /health redirecciona para o login, a verificação vê o redireccionamento e não o teu servidor saudável.
  • Uma verificação demasiado frequente é tráfego. Cada edge testa por si; um intervalo de cinco segundos multiplicado pela frota é mais pedidos do que muitos sites recebem de visitantes.

Ver Verificação de saúde para o detalhe de cada campo.

Quando a origem cai

Pela ordem em que tentamos:

  1. Servimos de cache o que estiver válido. Para um site sobretudo estático, os visitantes podem não notar nada.
  2. Passamos à origem seguinte, se tiveres mais do que uma.
  3. Devolvemos 502 quando não há cache nem alternativa — e o erro é nosso a dizer que não conseguimos falar com o teu servidor, não um erro do teu servidor.

Um 502 persistente é quase sempre a origem: parada, com a firewall a bloquear-nos, ou com o certificado expirado.

Depois de mudar de origem

Se mudaste de alojamento, muda a origem aqui e só depois desliga o servidor antigo. Na ordem inversa, há uma janela em que apontamos para uma máquina que já não existe.

← Toda a documentação