Disco

Volumes — quando a pasta precisa sobreviver

O disco de um container é descartável: tudo que o seu app grava nele desaparece quando a cópia é recriada, o que acontece em toda publicação. Para arquivo de usuário — upload, imagem, anexo — use o armazenamento de objetos, que é feito para isso. Volume é para o caso em que o programa exige uma pasta no disco e não aceita outra coisa.

Um volume tem nome e caminho de montagem. Ele é criado na hora, mas só passa a existir dentro do container na PRÓXIMA publicação do projeto: é no deploy que a montagem é declarada no motor. Até ali, o que o app escrever naquele caminho ainda se perde — e a tela de volumes diz exatamente isso, em vez de mostrar o volume como se já estivesse valendo.

Montado significa montado: o estado na tela só fica verde depois que o motor confirmou a declaração. Se ele recusar, o volume aparece como não montado e o fato entra na linha do tempo do projeto, porque escrever numa pasta que você acredita ser persistente e não é só se descobre quando o dado já foi.

O volume pertence ao serviço principal do projeto. Remover o volume desfaz a montagem; o conteúdo que está dentro dele não é apagado por aí.