Servidores

Um servidor é uma máquina Linux que você controla e onde seus agentes moram. A Bia instala o runtime lá e depois gerencia de fora. Esta página explica como isso funciona e o que esperar.

#Instalar um servidor

Em Servidores → Novo servidor, o assistente pede:

1. Um nome — como você quer chamar essa máquina no painel.
2. Como conectar — endereço, porta SSH e autenticação (senha ou chave privada). Precisa ser um acesso com poderes de root: a instalação mexe em serviços do sistema.
3. Um preset — o time de agentes que já sai instalado junto. Você pode escolher nenhum e criar os agentes depois.

#Que tamanho de servidor

Cada agente roda num processo próprio no servidor, então a necessidade cresce com o time que você instala. A regra é simples: 2 vCPU / 4 GB de RAM aguentam um agente; cada agente a mais precisa de uns 0,5 GB. O assistente diz o número exato para o preset que você escolher (mínimo e recomendado), e antes de instalar ele mede a máquina de verdade:

• abaixo do mínimo, a instalação é recusada com a conta na tela — escolha um preset menor ou um servidor maior;
• entre o mínimo e o recomendado, a instalação segue e a página do servidor mostra um aviso; a instalação também cria um arquivo de swap para um pico de memória não derrubar um agente;
• os discos: uns 20 GB livres bastam para começar.

Antes de instalar, o assistente mostra tudo que você escolheu em uma tela de revisão — vale conferir o endereço e a porta aqui, porque é o erro mais comum:

A instalação roda em segundo plano, e a página mostra o progresso etapa por etapa, com o log de cada uma. Costuma levar de 5 a 10 minutos.

#O que a instalação faz

• Instala o runtime de agentes e as dependências dele.
• Endurece o acesso SSH da máquina.
• Sobe os serviços que mantêm os agentes rodando e sincronizando.
• Instala um conector que fala com a Bia — é por ele que o painel recebe status e envia comandos.
• Provisiona os agentes do preset, se você escolheu um.

Quando termina, o servidor fica Pronto e passa a aparecer como Online.

Concluído com avisos. Uma instalação pode terminar bem e ainda assim ter algo a dizer — um item opcional que não instalou, uma memória apertada, uma ferramenta que ficou de fora. Esses passos aparecem em âmbar na lista, com as linhas que o servidor escreveu. Vale abrir: quase sempre é algo que se resolve com "Reinstalar o servidor" ou com um servidor maior.

#Versões instaladas

Tudo que um servidor novo recebe — o runtime dos agentes, o motor de missões, os itens padrão do marketplace, as versões de Node e PHP — vem de um conjunto de versões verificado: uma combinação que passou pela nossa rodada completa de testes nos servidores de teste antes de ser oferecida. Nada segue "a versão mais recente" por conta própria, porque é assim que uma instalação de segunda-feira acaba diferente de uma de sexta.

Na tela de revisão do assistente você vê exatamente o que vai ser instalado. Depois, na página do servidor, em Detalhes técnicos → Conjunto de versões, ficam o conjunto de origem e o que o servidor de fato reportou — se um dia divergirem, a linha fica em âmbar.

Depois da instalação, a senha SSH deixa de funcionar. O endurecimento troca o acesso para chave. Isso é intencional — mas guarde sua chave, porque é ela que te dá acesso à máquina fora da Bia.

Depois disso o servidor aparece na página Servidores, que tem três abas:

• Monitoramento — um cartão por máquina, com os sinais vitais que o conector reporta: uso de CPU, memória e disco, além do status do conector e da hospedagem. É a visão para bater o olho e ver se alguma máquina está apertada.
• Servidores — a mesma frota em formato de tabela, com status, instalação e último contato, para quando você quer ordenar ou comparar.
• Backups — o histórico de backups do negócio, explicado em Backups e restauração.

E a mesma frota na aba de tabela:

#Como a Bia fala com o servidor depois

Não é uma conexão SSH permanente. O servidor é quem inicia a conversa: ele consulta a Bia periodicamente para buscar comandos e reportar o que está acontecendo. Na prática:

• Nenhuma porta de entrada precisa ser aberta para a Bia.
• Se a máquina cair, o painel percebe pela ausência de contato e marca Offline.
• Comandos enfileirados enquanto o servidor está offline são entregues quando ele volta — ou expiram, se ficarem parados tempo demais.
• Se a Bia ficar fora do ar, é o seu servidor que percebe — ele é quem inicia o contato. Quando um agente do servidor tem Telegram configurado, você recebe um aviso por lá depois de alguns minutos de silêncio da central, e outro quando ela volta. O servidor continua funcionando normalmente nesse meio-tempo.

#Segurança: o que a instalação faz e o que fica com você

Tudo que a instalação faz segue boas práticas de segurança para novos deploys: o acesso SSH é endurecido para aceitar apenas chave, os serviços rodam com o mínimo de privilégio necessário e o conector fala com a Bia por HTTPS, sem precisar de porta de entrada aberta para a Bia.

A partir daí, a segurança do servidor é responsabilidade total sua — e envolve fatores que nenhum instalador alcança:

• Senhas secretas e seguras nas contas que continuam com você: o provedor da VPS, o painel dele e qualquer serviço que você mesmo instalar na máquina.
• Rotação regular de credenciais — chaves SSH, tokens e senhas não devem viver para sempre.
• Monitoramento constante através dos sistemas do provedor da VPS utilizada: alertas de acesso, firewall e snapshots são ferramentas dele, não da Bia.

A Bia provê facilidades para instalar e configurar os sistemas — a máquina, as contas e a exposição dela continuam em seu nome e sob seu controle.

#Atualizações: o que a Bia faz e o que fica com você

Três coisas diferentes se atualizam de três jeitos diferentes:

O conector e o núcleo de habilidades se atualizam sozinhos. Quando lançamos uma versão nova, o servidor percebe na próxima sincronização, baixa os scripts, confere a integridade deles e troca. Você não precisa fazer nada, e normalmente leva poucos minutos. O núcleo de habilidades se mantém atual sem apagar o que o agente aprendeu localmente.

Patches de segurança do sistema operacional são instalados todo dia, e ficam registrados. Uma vez por dia (por volta das 4h da manhã, no horário do servidor) a Bia roda uma passada de atualizações de segurança do Ubuntu — só os pacotes de segurança, nunca uma atualização geral — e anota o resultado. Na página do servidor, em Detalhes técnicos → Atualizações de segurança, você vê quando foi a última rodada, quantos pacotes subiram, o que ainda está pendente e se a máquina está pedindo um reinício. A Bia nunca reinicia o seu servidor sozinha: quando um patch de kernel pedir, o aviso aparece ali e você escolhe a hora. No próprio servidor, journalctl -u bia-patches mostra o histórico completo.

O resto do sistema e as ferramentas não são atualizados pela Bia. Runtime dos agentes, motor de missões, Node, PHP, Docker e os demais pacotes ficam na versão do conjunto verificado com que o servidor nasceu — uma combinação que sabemos funcionar junta. Atualizar isso é uma decisão sua, quando quiser e se precisar: por um novo conjunto verificado, com a ação Reinstalar o servidor na página dele (a instalação é feita para poder ser repetida), ou por sua conta, direto na máquina, sabendo que uma versão fora do conjunto pode se comportar de forma diferente do que testamos.

#Vários agentes no mesmo servidor

Um servidor hospeda quantos agentes você quiser (dentro do limite do seu plano). Cada um tem persona, memória e canais próprios, isolados um do outro. Eles podem colaborar — veja Tarefas e colaboração.

#Vários servidores

Nada impede ter mais de um. Motivos comuns: separar ambientes, aproximar um agente de um banco de dados, ou dividir custo. Agentes em servidores diferentes conseguem trabalhar juntos pelo quadro de tarefas.

#Chaves SSH

Em Credenciais → Chaves SSH ficam as chaves que a Bia usa para instalar. Você pode cadastrar a sua ou deixar a Bia gerar uma. A chave privada é guardada cifrada. A página Servidores também leva direto para lá, já que é ali que você costuma precisar dela.

#Remover um servidor

Excluir o servidor no painel remove o registro dele na Bia e para o gerenciamento. A máquina continua existindo e os agentes continuam rodando lá — remover da Bia não é o mesmo que desinstalar. Se você quer a máquina limpa, reinstale o sistema operacional ou apague o runtime manualmente.

#Próximos passos

• Agentes — criar agentes nesse servidor.
• Backups e restauração — proteger o que está lá.
• Solução de problemas — instalação falhou, servidor offline.