Serviços e processos

O JelinaOS utiliza um modelo padrão de gestão de serviços, reunindo sistema e aplicações. Os comandos comuns atendem à maioria das tarefas diárias de manutenção.

Principais serviços

Os serviços abaixo atuam em conjunto durante a operação. Use os nomes efetivamente presentes no dispositivo:

Serviço	Função
Runtime de contêineres — docker / containerd	Base de execução das aplicações em contêineres
Agente — jelina-jelinvisor	Conexão à nuvem, envio de estado e execução de atualizações
Host de serviços — jelina-services-host	Hospeda serviços na área /app e aciona a recuperação em caso de anomalia
Registro — jelina-register	Registro do dispositivo na nuvem
Watchdog — jelina-watchdog	Supervisão da integridade do sistema
Canal seguro	Comunicação criptografada entre dispositivo e nuvem
Monitor de espaço — jelina-free-space-monitor	Monitoramento e proteção do espaço de armazenamento
Sincronização de horário (jelina-time-sync)	Sincronização do relógio do sistema com o relógio de hardware
Montagem do sistema (jelina-bind-mount / jelina-mount-overlay-*)	Montagem de arquivos do kernel e da área de aplicações
Reversão de atualizações (jelina-rollback@)	Retorno de atualizações do sistema/kernel

Operações comuns

# Consulta o estado do serviço
systemctl status <nome_do_serviço>

# Inicia / para / reinicia
systemctl start <nome_do_serviço>
systemctl stop <nome_do_serviço>
systemctl restart <nome_do_serviço>

# Configura a inicialização automática com o sistema
systemctl enable <nome_do_serviço>
systemctl disable <nome_do_serviço>

Configuração do sistema

As configurações do sistema ficam em um diretório unificado e permitem sobreposições em camadas:

/etc/jelina.conf — configurações padrão do sistema;
/etc/jelina.conf.d/*.conf — configurações de sobreposição carregadas em sequência (as carregadas por último têm prioridade).

Após alterar uma configuração, reinicie os serviços correspondentes conforme necessário para aplicá-la.

Visualizar processos

ps aux                # Consulta todos os processos
top                   # Monitora processos em tempo real, ordenados por CPU/memória

Visualizar logs

# Consulta os logs do serviço
journalctl -u <nome_do_serviço>

# Acompanha logs em tempo real
journalctl -u <nome_do_serviço> -f

# Consulta as últimas 100 linhas
journalctl -u <nome_do_serviço> -n 100

Os logs do agente do dispositivo são registrados separadamente para facilitar o diagnóstico de problemas de conexão com a nuvem:

tail -f /var/log/jelinvisor

Gerenciar a inicialização automática

Há duas formas de iniciar aplicações automaticamente na inicialização do sistema:

Método	Aplicável a	Descrição
Aplicação em contêiner	Contêineres	Configure `--restart always` para restaurar automaticamente com o sistema
Aplicação nativa	Conjuntos de programas/serviços	Configuração declarativa ou `systemctl enable`

Gerenciar serviços pela nuvem

Após conectar o dispositivo ao JelinaCloud, também é possível executar pela nuvem:

Reiniciar serviços dos dispositivos: reiniciar em lote os serviços de aplicações de todos os dispositivos da frota;
Desligar/reiniciar dispositivos: desligar e reiniciar remotamente;
Controle do dispositivo: executar operações específicas em um único dispositivo.

Consulte Gerenciamento de frotas e manutenção remota.

Recomendações de diagnóstico

Se um serviço não iniciar, consulte primeiro os logs para identificar a causa;
Verifique se os serviços dos quais ele depende estão funcionando normalmente (aplicações em contêiner dependem do runtime de contêineres);
Serviços configurados com uma política de reinicialização se recuperam automaticamente após um encerramento anormal. Consulte os logs para identificar a causa da reinicialização.