Armazenamento Persistente

Por padrao, os dados dentro de um container sao efemeros — eles sao perdidos quando o servico e reiniciado ou um novo deploy e feito. Volumes persistentes resolvem esse problema, permitindo que dados sejam preservados entre reinicializacoes e deploys.

O que sao volumes persistentes?

Volumes persistentes sao espacos de armazenamento em disco que ficam vinculados ao seu servico. Diferente do sistema de arquivos do container, os dados em um volume persistente sobrevivem a:

• Reinicializacoes do servico
• Novos deploys
• Atualizacoes de imagem

Use volumes persistentes para armazenar dados como arquivos de upload, bancos de dados embarcados (SQLite), caches em disco ou qualquer dado que precise persistir.

Criando e vinculando um volume

1. Acesse a pagina do servico no dashboard
2. Va ate a aba Armazenamento
3. Clique em Novo Volume
4. Defina o tamanho do volume (em GB)
5. Defina o caminho de montagem — o diretorio dentro do container onde o volume sera acessivel (por exemplo, /data ou /app/uploads)
6. Clique em Criar

O volume sera criado e vinculado ao servico. Um novo deploy sera iniciado automaticamente para montar o volume.

Caminho de montagem

O caminho de montagem define onde o volume aparece dentro do container. Sua aplicacao acessa os dados do volume como se fossem arquivos normais nesse diretorio.

Exemplos comuns:

Uso	Caminho sugerido
Banco de dados SQLite	/data
Arquivos de upload	/app/uploads
Cache em disco	/app/cache
Logs persistentes	/var/log/app

Limites por plano

Consideracoes importantes

• Um volume por servico. Cada volume e vinculado a um unico servico.
• Redimensionamento. Voce pode aumentar o tamanho de um volume, mas nao pode reduzi-lo.
• Exclusao. Ao excluir um servico, os volumes associados tambem sao removidos permanentemente.
• Replicas. Volumes persistentes sao compartilhados entre as replicas do mesmo servico. Certifique-se de que sua aplicacao lida corretamente com acesso concorrente.