Gerenciar servidores
Servidores lista todos os servidores da sua organização com o ambiente de execução, o status, a versão do agente e o último sinal.

Status do servidor
Seção intitulada “Status do servidor”| Status | Significado | O que fazer |
|---|---|---|
| Pendente | Registrado, mas nenhum agente se inscreveu ainda. | Execute o comando de instalação no servidor. Consulte Conectar um servidor. |
| Conectado | O agente está se comunicando. | Nada a fazer. |
| Offline | Sem sinal há mais de 5 minutos. | Verifique se o servidor está ligado, se o agente está rodando e se o servidor consegue alcançar a plataforma por HTTPS. |
| Bloqueado | Um administrador cortou o acesso do agente. | Desbloqueie-o se o bloqueio foi um engano (veja abaixo). |
As instalações de um servidor offline continuam rodando. O portal só não consegue vê-las nem alterá-las até o agente se conectar novamente.
Detalhes do servidor
Seção intitulada “Detalhes do servidor”Clique em um servidor para abri-lo. A página mostra:
- Ambiente, Versão do agente, Último sinal e Recursos (CPU e memória informados pelo agente).
- Status do agente: disponibilidade nas últimas 24 horas, 7 dias ou 30 dias.
- Instalações neste servidor, com seu status e endereços web.
- Conexões entre instalações neste servidor.

Estas ações são para Administradores da organização.
Bloquear
Seção intitulada “Bloquear”Use esta ação se um servidor for perdido, roubado ou comprometido. Bloquear revoga imediatamente o acesso do agente, e o agente para na requisição seguinte. Os aplicativos que já estão no servidor continuam rodando, mas você não pode gerenciá-los até o servidor ser desbloqueado.
Desbloquear
Seção intitulada “Desbloquear”Desbloquear emite um novo token de uso único. A identidade antiga nunca mais é considerada confiável, por isso você precisa reinscrever o agente: pare-o, exclua a pasta de estado dele e execute novamente o comando de instalação com o novo token.
Regenerar token
Seção intitulada “Regenerar token”Use esta ação se você perdeu o comando de instalação antes de o agente se inscrever, ou se quer passar a identidade do servidor para um novo agente. Regenerar token desconecta imediatamente qualquer agente inscrito no momento como este servidor e volta o servidor para o status Pendente até que um agente se inscreva com o novo token. Depois, pare o processo do agente antigo.
Atualizar o agente
Seção intitulada “Atualizar o agente”Quando uma nova versão do agente é lançada, o cartão Versão do agente do servidor mostra Atualização disponível, com a versão em execução e a mais recente. Clique em Atualizar agente.
O agente baixa a nova versão, confere se ela foi assinada pela Scolah e reinicia no lugar. Suas instalações continuam rodando enquanto isso. O cartão mostra Atualizando e depois Atualizado.
Se a nova versão não iniciar, ou não conseguir se conectar à plataforma em 10 minutos, o agente volta para a versão anterior e o cartão mostra Versão anterior restaurada. O servidor continua na versão anterior, e você pode tentar de novo mais tarde.
- O servidor precisa estar Conectado, e só uma atualização roda por vez.
- Um agente executado manualmente em um terminal, e não como serviço, troca o programa mas pode precisar ser reiniciado para concluir. O cartão avisa.
- Em um cluster Kubernetes, o agente é uma release do Helm, então é atualizado pelo cluster:
helm upgrade scolah-agent oci://ghcr.io/engineeringpurple/charts/scolah-agent --reuse-values.
Marcar como elegível para recuperação
Seção intitulada “Marcar como elegível para recuperação”Um servidor só pode hospedar servidores de reserva de recuperação de desastres depois de ser marcado como elegível. Na página do servidor, o cartão Recuperação de desastres mostra Elegível para recuperação ou Não elegível para recuperação. Clique em Marcar como elegível para recuperação para permitir isso, ou em Remover elegibilidade para recuperação para deixar de oferecê-lo como servidor de recuperação. Remover a elegibilidade não afeta os servidores de reserva que já estão no servidor.

Tanto servidores Docker quanto clusters Kubernetes podem ser marcados como elegíveis para recuperação. Uma reserva em um cluster precisa de um armazenamento de artefatos, como descrito em Clusters Kubernetes.
Excluir
Seção intitulada “Excluir”Excluir remove o servidor da sua organização e revoga permanentemente as credenciais do agente dele. Você precisa remover primeiro todas as instalações do servidor. Para confirmar, digite o nome do servidor.
Excluir um servidor no portal não desinstala nada da máquina. Para limpar, pare o agente e remova a pasta de estado dele.
