Ir para o conteúdo

Documentação

Hetzner

A Hetzner vende duas coisas através de duas API: o Cloud, um projeto alugado de servidores virtuais faturados à hora, e o Robot, máquinas dedicadas com contrato mensal. Esta página trata da integração do Cloud, a única que pode ligar hoje, e tudo o que nela consta decorre dessa única diferença: os anfitriões não lhe pertencem, por isso não há nó a escolher, nem armazenamento a indicar, nem intervalo de numeração a distribuir.

Uma integração é um projeto

Um token de API da Hetzner pertence exatamente a um projeto e não vê nada fora dele. Uma conta com três projetos passa aqui a ser três integrações, cada uma com o seu token e o seu orçamento de pedidos.

Não conseguimos ler o nome do projeto: a Hetzner não tem nenhum endpoint para isso. Convém dar a cada integração um nome reconhecível, porque esse nome é a única coisa que as distingue no painel.

O token

Um campo, e são todas as credenciais. Crie-o na Hetzner Cloud Console, em Security → API tokens, dentro do projeto que o Provibr deve gerir.

  • Escolha Read & Write. Um token só de leitura liga-se sem problemas e o teste de ligação fica verde, porque esse teste apenas lê; falha no primeiro botão que altera alguma coisa.
  • Um token de leitura e escrita é tudo ou nada: sem âmbitos, sem data de validade, sem restrição de IP. Quem o tiver pode remover qualquer servidor desse projeto.
  • Cole o token exatamente como aparece. Um token com um espaço a mais é recusado, e a Hetzner comunica isso da mesma forma que um token errado.
O token passa diretamente para o agente e é aí selado. A plataforma guarda que existe uma integração, nunca o token em si.

As máquinas chegam pela importação

O Provibr ignora todos os servidores de que nada lhe foi dito, por isso uma integração acabada de criar mostra uma lista vazia. Abra a integração, execute a importação e assinale os servidores que quer ter no painel.

É intencional: num projeto costumam existir também máquinas que nada têm a ver com clientes, e adotá-las automaticamente colocá-las-ia na contagem de capacidade sem que ninguém o tivesse pedido.

O que pode fazer com uma máquina

Arrancar, parar, desligar de forma ordenada, remover e reconstruir sobre outra imagem. Remover remove mesmo: a máquina desaparece e a faturação termina. Uma reconstrução mantém tanto o endereço IPv4 como o bloco IPv6.

O encerramento ordenado é dado como bem-sucedido assim que o sinal ACPI é enviado, e não quando o sistema convidado lhe obedeceu. O estado pode continuar a indicar em execução durante alguns segundos.

A suspensão não existe, e não é uma falha

A Hetzner fatura um servidor enquanto ele existir, esteja ligado ou não. Desligá-lo custa exatamente o mesmo ao cliente e não lhe traz nada; por isso o Provibr não o oferece, e a aplicação dos limites de licença também não o faz.

Quando uma conta ultrapassa o seu limite, o Provibr comunica-o e recusa máquinas novas, mas não desliga nenhum servidor da Hetzner. Aqui, a forma honesta de libertar capacidade é remover uma máquina.

O que ainda não existe

Os volumes, as firewalls e os IP primários são na Hetzner objetos separados, com vida e preço próprios. Por isso não há aqui separador de hardware, nem regras de firewall, nem atribuição de endereços. Também não é possível pausar: a Hetzner não tem suspensão própria, pelo que uma máquina que ultrapassa a capacidade é desligada.

O Robot, a linha dedicada da Hetzner, é uma integração à parte com anfitrião próprio e credenciais próprias, e ainda não liga. Quando ligar terá uma secção própria nesta página: os passos são mesmo diferentes, por isso vão continuar separados em vez de se fundirem numas únicas instruções.