Persistência de Configurações da Plataforma
Nada mina mais a confiança numa plataforma do que configurar tudo com capricho — contextos, prompts, matriz de visibilidade — e ver o trabalho sumir depois de uma atualização. No DATTA isso não acontece: toda configuração de execução feita pela interface é gravada em armazenamento durável e sobrevive a reinícios, atualizações e até à reinstalação da plataforma, sem nenhuma ação sua.
Desde 8 de maio de 2026, a configuração de execução e os prompts ficam em um volume dedicado da instalação. Antes disso eles moravam em uma área temporária (/tmp/datta-runtime-config.json) e os domínios cadastrados pela interface sumiam a cada reinício — o problema que esta mudança encerrou.
O que é preservado
- Contextos e domínios de dados cadastrados pela interface, em .
- Prompts por contexto, guardados na pasta de prompts do mesmo volume.
- Demais configurações de execução ajustadas pelo console.
A gravação é imediata: salvou na interface, está persistido. Não existe um passo extra de "aplicar" ou "publicar".
Como o armazenamento é dimensionado
Os parâmetros abaixo fazem parte da instalação da plataforma e raramente precisam de ajuste:
| Parâmetro | Padrão | Para que serve |
|---|---|---|
| Persistência | ligada | Mantém configuração e prompts fora da área temporária |
| Tamanho do volume | 1 GiB | Folga larga: configuração + prompts ocupam ~50 KB tipicamente |
| Classe de armazenamento | vazia | Usa o armazenamento padrão da instalação |
DATTA_CONFIG_PATH | /data/datta-config/runtime-config.json | Arquivo da configuração de execução |
DATTA_PROMPTS_PATH | /data/datta-config/prompts | Pasta dos prompts por contexto |
O volume é criado pela própria instalação com política de retenção: ele é preservado mesmo quando a plataforma é desinstalada. Uma reinstalação encontra contextos e prompts exatamente onde estavam — reinstalar nunca custa a configuração.
Backup e restauração
Mesmo com persistência automática, mantenha cópias de segurança: elas cobrem perda de disco e erro humano (por exemplo, a exclusão indevida de um contexto).
- Instantâneos do volume — o ambiente de armazenamento permite tirar snapshots do volume de configuração. O agendamento automático desses instantâneos ainda não está entregue; hoje eles são disparados sob demanda.
- Restauração manual — o procedimento é: copiar o arquivo
runtime-config.jsondo volume para fora, guardá-lo como backup e, na hora de restaurar, devolvê-lo ao mesmo caminho e reiniciar o módulo de configuração da plataforma. Tudo isso é feito pelo console de administração, sem acesso direto à infraestrutura.
Migração de instalações antigas
Instalações anteriores a essa mudança, que ainda gravavam na área temporária, perdem a configuração ao atualizar — ela não é migrada automaticamente. Nesse caso:
- Recadastre os domínios pela interface em ou com o script
scripts/recreate-domains.sh. - Não é preciso mais nada: a catalogação automática dispara para cada domínio novo e repovoa o Knowledge Catalog em segundo plano.
Boas práticas
- Não tente contornar a persistência apontando as configurações de volta para áreas temporárias "para desenvolvimento". O armazenamento durável é provisionado na hora, mesmo em instalação local, e não tem custo extra — a área temporária apenas devolve o problema original.
- O armazenamento de configuração tem um único escritor. Por isso o módulo de configuração roda em instância única; múltiplas réplicas simultâneas não são suportadas na versão atual. Uma configuração de alta disponibilidade exigiria armazenamento compartilhado com escrita concorrente ou mover a configuração para o cache compartilhado da plataforma.
- Backups periódicos da configuração junto com os dados, na mesma rotina da equipe de operações.