Uma stack do Compose pode ligar um novo volume nomeado vazio se a reimplementação alterar o nome do volume associado ao projeto ou não conseguir encontrar o volume original.
Os dados antigos podem ainda existir noutro volume do Docker, enquanto o serviço recriado monta um volume recém-gerado no mesmo caminho do contentor. Entre as causas comuns estão a alteração do nome da stack ou do projeto, a mudança do nome da chave do volume, a remoção através de um comando que elimina volumes, a perda de uma declaração de volume externo, a implementação através de outro gestor ou um nome de volume explícito que agora é resolvido de forma diferente. Faça o inventário do volume montado e dos candidatos órfãos antes de restaurar os dados ou inicializar a aplicação.
Identifique o volume exato montado pelo novo contentor
Inspecione os pontos de montagem do contentor em execução e registe o nome do volume, o controlador, o ponto de montagem, as etiquetas, a data de criação, o destino no contentor e o modo de leitura e escrita. Compare-os com os registos anteriores à reimplementação.
O comando docker volume inspect do Ubuntu revela a identidade do volume, permitindo distinguir o novo volume vazio de um volume antigo não montado com um nome semelhante.
Não copie dados para o novo volume até localizar o original. Iniciar a aplicação pode criar uma nova base de dados e fazer com que o destino pareça ter sido inicializado intencionalmente.
Verifique se o nome do projeto Compose foi alterado
Compare o nome do projeto antigo e do novo, o nome da stack, o diretório do Compose, a opção -p, COMPOSE_PROJECT_NAME, o name: de nível superior e o gestor de implementação.
O Docker explica que o Compose normalmente atribui a um volume o nome nome-do-projeto mais chave-do-volume, a menos que seja configurado um nome explícito ou uma pesquisa de volume externo.
Mover o mesmo ficheiro Compose para outro diretório pode, por isso, criar um segundo projeto e um segundo volume, mesmo que as chaves do serviço e do volume não sejam alteradas.
Verifique o nome estável e as definições do volume externo
Compare a definição do volume de nível superior antes e depois da nova implementação. Verifique name:, external:, as opções do controlador, as variáveis de interpolação e se o volume esperado existe.
O tutorial da Microsoft sobre Docker Compose refere que os volumes nomeados persistem independentemente da substituição dos contentores; por isso, um novo estado vazio significa, regra geral, que foi anexado um volume com outra identidade ou que o volume antigo foi removido.
Marque um volume como externo apenas quando o respetivo ciclo de vida for gerido intencionalmente fora da pilha. O Compose deve apresentar um erro claro quando um volume externo não existir, em vez de criar silenciosamente um volume de substituição.
Verifique se uma limpeza removeu o volume original
Reveja os registos de implementação, os scripts, as ações da interface, as tarefas de limpeza e os comandos para eliminar volumes. Compare a data de criação do volume com o evento de nova implementação.
A Red Hat documenta que os volumes nomeados geridos pelos contentores têm localizações de armazenamento separadas das camadas de escrita dos contentores, pelo que remover um contentor e remover o respetivo volume nomeado são eventos distintos do ciclo de vida.
Se o volume original não existir, interrompa os arranques automáticos e restaure apenas a partir de uma cópia de segurança verificada. Não parta do princípio de que um volume de substituição vazio contém uma camada eliminada recuperável.
Compare a identidade definida pelo gestor da pilha e o método de implementação
Registe se a pilha foi iniciada pela CLI, pelo Portainer, pela loja de aplicações do NAS, por uma implementação Git ou por outra ferramenta de automatização. Compare o nome da pilha e os valores de ambiente guardados por esse gestor.
O Portainer exige um nome descritivo para a pilha durante a implementação, e essa identidade controlada pelo gestor pode ser diferente do nome do projeto baseado no diretório utilizado por um comando manual do Compose.
Assim, um início manual de emergência pode criar recursos com o prefixo de outro projeto. Escolha um único responsável pela implementação e documente os nomes dos volumes resultantes.
Excluir a possibilidade de os dados estarem ocultos por baixo da nova montagem do volume
Pare o contentor e inspecione a imagem ou o caminho de ligação sem o volume nomeado associado, num teste descartável. Determine se, durante o arranque, foram escritos dados na camada do contentor antes de o volume ser montado.
O manual do Linux sobre montagem explica que uma montagem oculta o conteúdo preexistente do diretório, pelo que os dados podem parecer perdidos quando um novo volume vazio cobre os ficheiros criados na imagem ou na camada de escrita.
Não combine às cegas a camada oculta e o volume persistente antigo. Identifique qual dos estados contém os dados corretos e utilize o método de recuperação suportado pela aplicação.
Voltar a ligar o volume original com um teste controlado
Pare a stack, crie cópias de segurança de ambos os volumes candidatos, ligue o original a um contentor descartável ou ao caminho temporário de um serviço e verifique os ficheiros da aplicação, a identidade da base de dados, as permissões e os carimbos temporais.
O guia da ZimaSpace sobre mover dados de contentores sem interromper as montagens apresenta o fluxo de trabalho complementar para o mapeamento de caminhos; este artigo centra-se na identidade dos volumes nomeados associados a projetos.
O problema fica resolvido quando o volume antigo pretendido é montado com um nome explícito estável ou como volume externo e as implementações repetidas o reutilizam sem criar outro volume vazio.
Perguntas frequentes
Um volume nomeado vazio significa que os dados antigos foram eliminados?
Não necessariamente. O volume antigo pode continuar a existir com outro prefixo de projeto ou um nome explícito, enquanto o novo contentor usa um volume vazio diferente.
Mudar o nome da pasta do Compose pode criar um novo volume?
Sim. Quando não há um nome de projeto fixo, o Compose pode deduzi-lo a partir do diretório do projeto e criar recursos com prefixos diferentes.
Os volumes importantes devem ser marcados como externos?
Os volumes externos podem impedir que a remoção da stack faça a gestão do respetivo ciclo de vida, mas exigem criação, atribuição de nomes, cópias de segurança e verificações de implementação cuidadosas.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



