Atualizações do sistema

O mecanismo de atualização do JelinaOS abrange quatro categorias: sistema, kernel, agente do dispositivo e atualizações incrementais, com canais de atualização pela nuvem e local. Com o mecanismo de sistema duplo A/B, toda atualização tem uma opção de retorno.

Componentes atualizáveis

Objeto da atualização	Descrição
Sistema (JelinaOS)	Atualização da versão do sistema, incluindo evolução de funcionalidades e correções de segurança
Kernel	Atualização da versão do kernel, com melhorias de desempenho e suporte a hardware
Agente do dispositivo	Atualização do componente de gerenciamento de dispositivos
Atualização incremental	Patches incrementais do sistema para implantação rápida

Métodos de atualização

OTA pela nuvem (recomendado)

Após conectar o dispositivo ao JelinaCloud, gerencie as atualizações de forma unificada pela página da frota ou do dispositivo:

Especifique na nuvem a versão de destino (sistema/kernel/agente);
A nuvem distribui a atualização conforme a política definida (com suporte à fixação de versões e execução em lotes);
O dispositivo baixa e aplica a atualização automaticamente, e o estado fica visível na nuvem em tempo real.

As atualizações pela nuvem também oferecem pacotes de atualização offline: baixe pacotes para dispositivos sem acesso à rede e aplique-os localmente, sem conexão. Também é possível entregar os pacotes por mídia removível, como uma unidade USB; o dispositivo processa automaticamente a atualização quando a mídia é conectada.

OTA local

Quando não houver ambiente de nuvem, use a ferramenta de atualização no dispositivo:

# Consulta a versão e o estado das atualizações
jelina-local-ota -g
jelina-local-ota -s
jelina-local-ota --json --status      # Saída estruturada do estado

# Consulta atualizações pendentes de confirmação no modo de confirmação local
jelina-local-ota --confirmation

# Pré-verifica o pacote de atualização, sem submetê-lo; apenas interpreta e valida
jelina-local-ota --check <pacote_de_atualização>

Após verificar que tudo está correto, submeta o pacote para aplicação (se o mecanismo de confirmação estiver habilitado, a atualização ficará pendente e só será executada após a confirmação):

jelina-local-ota <pacote_de_atualização>
jelina-local-ota -c -w    # Confirma a atualização pendente atual e acompanha o progresso

Pacotes de atualização de um único componente (.pkg)

Pacotes de um único componente (como o agente do dispositivo ou componentes de aplicações) podem ser aplicados pelo instalador:

jelina-instpackage --pkg-info <pacote_de_componente.pkg>   # Consulta informações do pacote sem instalá-lo
jelina-instpackage <pacote_de_componente.pkg>              # Instala o pacote de componente

Antes de instalar, confira a origem do pacote e a soma de verificação. Alguns componentes exigem uma reinicialização para que a atualização entre em vigor.

Tipos de pacote de atualização

O JelinaOS usa dois formatos de pacote de atualização, com finalidades e pontos de entrada diferentes:

Tipo de pacote	Formato	Finalidade	Ponto de entrada da instalação
Pacote de um único componente	`.pkg`	Atualizar um componente (sistema/kernel/agente do dispositivo/componente de aplicação etc.)	`jelina-instpackage`
Pacote de atualização OTA	`.zip`	Atualização completa (inclui o estado desejado e vários componentes, orquestrados pelo agente do dispositivo)	`jelina-local-ota`

Métodos de instalação

Os pacotes de um único componente usam métodos de instalação diferentes conforme o destino:

Método	Descrição
Gravação completa	Grava na partição de destino (geralmente a partição A/B de reserva)
Instalação por extração	Extrai para uma partição, arquivo ou diretório especificado
Instalação incremental	Instala como camada de sobreposição (atualização incremental, sem alternar partições)
Instalação com execução	Instala e executa uma vez (alto risco, apenas para cenários específicos)

Instalação bem-sucedida não significa ativação

Um retorno de sucesso do instalador não significa que o novo conteúdo já está em uso: componentes como sistema e kernel precisam de reinicialização ou remontagem após a atualização para serem ativados. Após reiniciar, verifique a versão e a partição efetivamente em execução antes de confirmar a conclusão da atualização.

Os dois tipos de pacote não são intercambiáveis

Não envie pacotes OTA (.zip) ao instalador de um único componente e não instale manualmente pacotes de um único componente (.pkg) ignorando o estado desejado — isso compromete a ordem de atualização entre componentes;
Aplique os pacotes OTA offline baixados da nuvem pelo ponto de entrada jelina-local-ota.

Confirmação de atualização

Em instalações críticas, as atualizações podem ser configuradas para execução após confirmação local:

Quando uma nova versão publicada na nuvem chega ao dispositivo, ela é armazenada, sem instalação imediata;
A atualização só começa após a confirmação da equipe local;
A confirmação pode ser feita por comando no dispositivo ou pela interface do dispositivo;
Até a confirmação, o dispositivo continua executando a versão atual, e a equipe local mantém a decisão final.

Processo de atualização e garantias de segurança

Baixar pacote → Verificar integridade → Gravar na partição de reserva → Reiniciar e alternar → Verificar inicialização
                                                            │
                                                ✅ Aprovado: continuar executando
                                                ❌ Falha: retornar automaticamente ao sistema anterior

Atualização sem interromper a operação: o download e a gravação ocorrem em segundo plano, enquanto o dispositivo continua funcionando;
Reversão automática em caso de falha: se a verificação após a alternância falhar, o sistema retorna automaticamente à versão anterior;
Reversão de versão: se a nova versão aplicada apresentar problemas, é possível retornar à versão anterior.

Consultar o estado da atualização

jelina-info          # Consulta a versão atual e a partição de inicialização
jelina-local-ota -s  # Consulta o estado das atualizações e as atualizações pendentes

O painel do dispositivo na nuvem também mostra a versão e o estado da atualização.

Recomendações de atualização

Cenário	Recomendação
Manutenção de rotina	Aplique patches em tempo hábil para manter a linha de base de segurança
Atualização de versão	Valide primeiro em dispositivos de teste e depois implante em lote
Setores com exigências rigorosas de conformidade	Habilite a confirmação local e valide cuidadosamente antes de atualizar
Instalações com largura de banda limitada	Use atualizações incrementais ou pacotes offline

Documentação relacionada

Mecanismos de atualização e recuperação de desastres — princípios das atualizações e garantias de segurança
Implantação de aplicações pela nuvem e OTA — operações de atualização pela nuvem
Sistema duplo A/B e alternância — alternância de partições e reversão