Armazenamento e partição de dados

O armazenamento do JelinaOS segue o princípio de “sistema seguro e dados sob controle”: a partição do sistema opera em modo somente leitura e todos os dados do usuário ficam centralizados em uma partição de dados independente.

Organização do armazenamento

┌──────────────────────────────────────────────────────────────┐
│ Partição do sistema (somente leitura)                        │ Sistema principal, sem gravação durante a execução
├──────────────────────────────────────────────────────────────┤
│ Área de aplicações (/app, camada somente leitura + gravável) │ Aplicações e componentes, independentes do sistema
├──────────────────────────────────────────────────────────────┤
│ Partição de dados (/mnt/overlay/rw)                          │ Todos os dados e gravações do usuário
│ ├─ Camada gravável do sistema (root upper)                   │
│ ├─ Camada gravável de aplicações (app upper)                 │
│ ├─ Arquivos de configuração / logs de execução               │
│ └─ Arquivos do usuário                                       │
└──────────────────────────────────────────────────────────────┘

A partição do sistema opera em modo somente leitura e não pode ser alterada;
A área de aplicações (/app) é montada separadamente; as atualizações de aplicações e componentes não ocupam a partição do sistema;
A partição de dados recebe todas as gravações do usuário e fica isolada das aplicações e do sistema.

Onde armazenar os dados

Tipo de dado	Localização	Descrição
Dados de aplicações	Diretório da aplicação na partição de dados	Volumes de contêineres e dados de execução de programas
Arquivos de configuração	Diretório de configuração na partição de dados	Configurações persistentes, preservadas nas atualizações
Logs	Logs do sistema + partição de dados	Política de retenção configurável conforme a necessidade
Dados temporários	Memória do sistema/diretório temporário	Apagados ao reiniciar, sem ocupar espaço persistente

Consultar o espaço de armazenamento

df -h

Acompanhe principalmente o espaço livre na partição de dados — ela concentra a maior parte do armazenamento disponível do dispositivo.

Esgotamento de espaço e recuperação com raiz temporária

O sistema inclui monitoramento de espaço em disco para proteger continuamente o espaço da partição raiz. Quando o espaço está próximo de se esgotar, o dispositivo pode entrar no modo de recuperação com raiz temporária (temporary root):

O sistema inicia com uma raiz temporária (usando a memória como camada gravável) para permitir liberar espaço ocupado, sem afetar o conteúdo da partição de dados;
A raiz temporária é um modo de recuperação: todas as gravações realizadas nela são perdidas após a reinicialização. Ela serve apenas para acessar o sistema e liberar espaço;
O modo é acionado quando o uso do espaço atinge o limite (90% por padrão; pode ser configurado para apenas emitir um alarme, solicitar uma reinicialização ou forçar a reinicialização);
Use o comando do dispositivo para consultar o estado da raiz temporária:

jelina-enter-tmpfs-root --status   # Consulta o estado da raiz temporária
jelina-info --get tmp_root --json  # Detalhes da raiz temporária

Depois de liberar espaço na partição de dados durante o modo de raiz temporária, reinicie novamente para retornar ao modo normal.

Quando o espaço se esgotar, priorize a limpeza de logs de aplicações, imagens de contêineres e arquivos temporários. Evite excluir o estado do sistema e os marcadores de atualização. Não execute operações de negócio nem altere configurações no modo de raiz temporária.

Recomendações de gerenciamento de espaço

Limpeza periódica: logs antigos podem consumir muito espaço. É possível limitar o espaço ocupado pelos logs:
Terminal window
```
journalctl --vacuum-size=200M   # Limita o espaço ocupado pelos logs
```
Monitoramento e alarmes: após conectar o dispositivo ao JelinaCloud, é possível configurar um limite de alarme para o uso do armazenamento (80% por padrão), com notificação automática ao excedê-lo;
Reserva de espaço: as atualizações do sistema precisam de espaço temporário. Recomenda-se manter mais de 20% da partição de dados livre.

Backup de dados

A partição de dados é o único local persistente para os dados do usuário. Recomenda-se fazer backups periódicos:

Faça backup dos dados importantes em armazenamento externo ou na nuvem;
Antes de operações relevantes, como atualizações e manutenção, faça backup dos diretórios importantes da partição de dados;
Armazene os backups fora da partição de dados (em disco externo ou armazenamento de rede) para evitar um ponto único de falha.

Restauração de fábrica e dados

A restauração das configurações de fábrica retorna o sistema e as gravações do usuário ao estado de fábrica;
Faça backup dos dados importantes antes de executar a restauração.

Documentação relacionada

Arquitetura do sistema — organização das partições e princípios de isolamento dos dados
Recovery e restauração das configurações de fábrica — instruções completas de recuperação