Agente Jelinvisor

O Jelinvisor é o componente de gestão executado em cada dispositivo JelinaOS e a ponte com a plataforma JelinaCloud. Ele viabiliza o registro automático na nuvem, as atualizações com continuidade de conexão e a manutenção remota.

Responsabilidades

Responsabilidade	Descrição
Conexão do dispositivo	Registrar automaticamente na nuvem após a primeira inicialização e manter o estado online
Comunicação do estado	Informar continuamente versão do sistema, endereços de rede, recursos, temperatura, estado das aplicações e outros dados
Execução de atualizações	Receber e aplicar atualizações de sistema, kernel, aplicações e incrementos, incluindo confirmação e retorno à versão anterior
Gestão de aplicações	Gerenciar todo o ciclo de vida de aplicações em contêineres e fora deles (ProgramSet): iniciar, parar, reiniciar e atualizar
Interface local	Fornecer interfaces de gestão para consulta de estado, operações de serviços e controle local do dispositivo
Canal remoto	Encaminhar solicitações de gestão por um canal seguro quando a nuvem não puder acessar diretamente o dispositivo

Quatro modos de operação

O Jelinvisor oferece diferentes modos conforme o ambiente de implantação e suas condições de rede e gestão:

Modo	Cenário	Comportamento
Gestão pela nuvem	Cenário padrão com JelinaCloud	Registro completo, comunicação de estado e recebimento de comandos da nuvem
Gestão local	Rede interna ou ambiente isolado, sem nuvem	Implantação e gestão de aplicações pela interface local
Offline	Interrupção temporária da rede	Preserva a configuração da nuvem, suspende a comunicação e reconecta automaticamente após a recuperação
Independente	Implantação totalmente sem nuvem	Autogestão local, sem dependência de componentes em nuvem

Em todos os modos, os recursos locais, como execução de aplicações, gestão do sistema e watchdog, permanecem disponíveis.

Integração com a nuvem

┌──────────────────────┐                                          ┌──────────────────────┐
│ Dispositivo de borda │      ① Registro / reporte de estado      │                      │
│ ┌────────────┐       │    ────────────────────────────────▶     │ JelinaCloud          │
│ │ Jelinvisor │       │    ◀────────────────────────────────     │ Plataforma de nuvem  │
│ └────────────┘       │② Atualizações / configurações / comandos │                      │
│ JelinaOS             │   ③ Canal seguro de manutenção remota    │                      │
└──────────────────────┘                                          └──────────────────────┘

1. Envio à nuvem: comunicação contínua de estado, logs e alertas, com visualização em tempo real.
2. Envio ao dispositivo: orquestração e distribuição de atualizações do sistema, Releases e políticas de execução.
3. Comunicação bidirecional: SSH remoto, área de trabalho remota e operações de serviços pelo canal seguro.

Projetado para a segurança no campo

• Confirmação local de atualizações: atualizações críticas podem aguardar confirmação após chegar ao dispositivo. A equipe local mantém a decisão final sobre a instalação.
• Autenticação de acesso: as interfaces locais usam autenticação por chave e rejeitam solicitações não autorizadas. As chaves podem ser regeneradas conforme necessário.
• Modo de produção: acesso apenas pela nuvem, sem conexão direta mesmo na rede local, reduzindo a superfície de ataque.
• Recuperação de conexão: a conexão é restabelecida automaticamente quando a rede retorna, sem intervenção manual.

Interface local

O agente oferece interfaces de gestão no próprio dispositivo para manutenção em campo e integração por scripts:

• Endereço local: localhost:48484; a porta pode ser alterada na configuração.
• Interfaces comuns: verificação de prontidão do processo, consulta de versão e estado de atualização, pré-verificação do estado de destino e confirmação de atualização.
• Prefira os comandos do dispositivo, como jelina-local-ota, nas operações diárias: eles tratam automaticamente configurações e informações sensíveis. Quando precisar chamar a interface diretamente, utilize o endereço de loopback local.

Verificação de integridade

jelina-info --get jelinvisor --json        # Estado e versão do agente do dispositivo
systemctl status jelina-jelinvisor          # Estado do serviço
journalctl -u jelina-jelinvisor -n 100      # Logs do agente

Atualizar o agente e o sistema

O próprio Jelinvisor aceita atualizações online, orquestradas pela nuvem junto com sistema, kernel e aplicações. Manter o agente atualizado sustenta a segurança e a evolução dos recursos do dispositivo.

Base técnica

O Jelinvisor utiliza uma arquitetura consolidada de gestão de dispositivos e incorpora anos de experiência com grandes conjuntos de equipamentos, oferecendo uma base de confiabilidade validada para implantações industriais em escala.

Documentação relacionada

• Registro e conexão do dispositivo — como conectar ao JelinaCloud.
• Gestão de frotas e manutenção remota — gestão em lote de grupos de dispositivos.
• Implantação de aplicações pela nuvem e OTA — publicação e atualização de aplicações.