Fluxo de migração de volumes Docker com nome entre dois servidores domésticos

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

A abordagem segura consiste em tratar um arquivo criado com os processos em pausa ou uma cópia sincronizada para um volume de destino explicitamente identificado, seguida de validação por soma de verificação e da aplicação, como uma sequência de etapas verificáveis, e não como um único comando.

Em dois servidores domésticos Linux com Docker Compose, o risco prático é ter de mover um contentor com estado para outro anfitrião sem copiar um volume ativo ou com um nome incorreto. Registe a identidade atual e o ponto de recuperação, comece pelo método menos invasivo para distinguir as opções, interprete os resultados positivos e negativos antes de alterar outra variável e pare se o armazenamento ficar instável ou se a única cópia recuperável ficar exposta. O fluxo de trabalho abaixo só termina quando a carga de trabalho original funcionar ou quando as evidências atingirem um limite que exija escalamento.

Identifique os contratos dos volumes de origem e de destino

Registe o resumo criptográfico da imagem do contentor de origem, o nome do projeto Compose, o serviço, a chave do volume, o nome real do volume Docker, o destino da montagem, o controlador do volume e a versão da aplicação. Use docker inspect e docker volume inspect; não deduza o caminho físico apenas com base num rótulo YAML.

Por predefinição, o Compose acrescenta o nome do projeto aos nomes dos volumes, a menos que seja usado um nome explícito ou um volume externo. No destino, apresente a configuração do Compose e crie explicitamente o volume vazio pretendido, para que a migração não acabe num volume enquanto o serviço inicia outro.

Se o volume contiver uma base de dados, use a exportação nativa ou uma cópia de segurança suportada como principal método de recuperação portátil e trate a cópia do volume como um ponto de recuperação para a mesma versão. Pare se o controlador for remoto, se o armazenamento de origem estiver instável ou se o estado da aplicação abranger volumes adicionais que não estejam incluídos no âmbito.

Coloque os processos de escrita em pausa e crie uma cópia que preserve os metadados

Coloque a aplicação em modo de manutenção, pare os processos em segundo plano e, em seguida, pare a aplicação e a base de dados de forma limpa. Confirme que nenhum contentor monta o volume com acesso de leitura e escrita. Crie um arquivo através de um contentor temporário ou use uma cópia controlada do sistema de ficheiros que preserve a propriedade numérica, as permissões, as ligações simbólicas, os atributos estendidos, se necessário, e os ficheiros esparsos.

Um guia independente sobre a migração de volumes Docker com rsync demonstra como mover dados de volumes Docker com rsync. O limite importante é que a origem tem de estar em estado de inatividade e o comando de cópia tem de operar sobre o conteúdo do volume identificado, sem manipular às cegas o diretório interno do Docker enquanto o daemon o está a utilizar.

Gere um manifesto com a contagem de ficheiros, o total de bytes, hashes representativos e a soma de verificação do arquivo. Mantenha o volume de origem e a cópia de segurança nativa intactos; a fase de cópia só fica concluída quando o artefacto de transferência puder ser lido no anfitrião de destino.

Restaure para o volume de destino explícito

Verifique a capacidade do sistema de ficheiros de destino, a disponibilidade de inodes, os valores esperados de UID e GID e a mesma versão da imagem da aplicação. Restaure o arquivo no volume de destino vazio sem remover a estrutura de diretórios de nível superior e, em seguida, compare a propriedade, as contagens, os tamanhos e hashes de ficheiros selecionados.

Uma discussão da comunidade sobre falha na migração de um volume com nome mostra por que motivo substituir diretamente ficheiros nos diretórios internos dos volumes do Docker pode falhar ou deixar o estado confuso. Use o ambiente de execução para montar o volume num contentor auxiliar e efetue o restauro através dessa interface controlada.

Ligue primeiro apenas uma cópia descartável do serviço, usando portas alternativas e sem acesso aos sistemas de produção interligados. Se a aplicação indicar atualizações do esquema ou um estado corrompido, pare e restaure novamente o volume a partir do artefacto inalterado depois de resolver a compatibilidade de versões.

Faça a migração e mantenha um anfitrião de reversão

Inicie as dependências antes da aplicação e verifique os registos, o início de sessão, os registos recentes, os anexos, as tarefas agendadas e uma gravação descartável. Reinicie a pilha no destino e confirme que volta a associar o mesmo volume com nome. Atualize o proxy ou o DNS apenas depois de estas verificações serem aprovadas.

O artigo relacionado da ZimaSpace sobre cópia de segurança consistente dos dados do contentor pode ajudar se o destino ficar vazio apesar de uma cópia bem-sucedida. Compare a origem da montagem em tempo de execução com o volume pretendido antes de voltar a copiar os dados; as cópias repetidas para o destino errado só aumentam a confusão.

Mantenha a aplicação de origem parada e o volume antigo em modo só de leitura até que uma nova cópia de segurança e um teste de restauro sejam bem-sucedidos no destino. Reverta a migração encaminhando novamente o tráfego para a origem inalterada apenas se o destino não tiver aceitado novas gravações; caso contrário, pare e reconcilie os dados deliberadamente.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.