Pular para o conteúdo

Instalar um node

Cadastrar um ou vários nodes num cluster e instalar cada servidor com o comando gerado pelo painel.

Quem pode: quem tem Escrever no DNS Recursivo (Editor ou Gerente).

  • Sistemas suportados: Debian 12, Debian 13 e Ubuntu 24.04 LTS. Use uma instalação limpa, de 64 bits, com acesso à internet para baixar os pacotes. Outras versões são recusadas na pré-checagem.
  • O cluster já precisa existir. Veja Clusters, anycast e prefixos.
  1. Abra Clusters, clique no cluster e abra a aba Nodes.

    Aba Nodes do cluster

  2. Em Adicionar nodes, preencha Hostname, IPv4, IPv6 e Porta SSH de cada node. Use + Linha para mais linhas e Tirar para apagar uma.

  3. Para muitos nodes, clique em Colar CSV em vez disso e cole no campo Colar CSV uma linha por node, no formato hostname,ipv4,ipv6,porta_ssh. O cabeçalho é opcional. Exemplo:

    hostname,ipv4,ipv6,porta_ssh
    dns-01,198.51.100.11,2001:db8::11,22
    dns-02,198.51.100.12,,22

    Adicionar nodes com o campo Colar CSV

  4. Clique em Revisar. O painel confere tudo e diz quantos nodes seriam criados, sem gravar nada.

  5. Clique em Criar nodes. Se alguma linha tiver erro, nada é gravado e o erro aparece com o número da linha.

  6. Em Comandos de instalação, os nodes ainda não instalados já vêm marcados na tabela. Clique em Gerar comandos dos selecionados. Para servidor com pouco hardware, marque antes Instalar mesmo se algum servidor tiver hardware insuficiente (fica registrado).

    Comandos de instalação gerados para o node

  7. Para cada node, clique em Copiar e rode o comando como root no servidor. Sem curl, abra Sem curl no servidor? e use a outra opção. O painel mostra por quanto tempo o comando vale.

  8. Para um node só, ou para reinstalar, abra o node, aba Instalação e ajustes, e clique em Gerar comando de instalação.

O comando faz a pré-checagem, instala BIND9, nftables, FRR e o agente, e aplica a configuração do cluster. O node passa por Pendente, Checando e Instalando até Ativo, e as métricas começam a chegar a cada 30 segundos. Cada comando vale 1 hora e funciona uma vez; gere outro quando precisar.

  • “Hostname … inválido: letras minúsculas, números, hífen e ponto, até 63 caracteres entre pontos.” Corrija o nome nessa linha.
  • “Hostname … repetido (linha N).” ou “Há IPs em conflito.” Cada node precisa de nome e IPs próprios.
  • “Porta SSH inválida.” ou “Linha mal formada.” Confira a linha no formato hostname,ipv4,ipv6,porta_ssh.
  • “No máximo 500 nodes por vez.” Divida a lista em partes.
  • “Selecione os nodes na tabela.” Marque os nodes em Comandos de instalação.
  • “Expirado: gere outro.” O comando passou de 1 hora. Gere um novo.
  • O node fica com Falhou: confira o sistema operacional e o acesso à internet do servidor.