Uma migração da base de dados pode ser executada duas vezes quando mais do que um ponto de arranque, contentor ou agendador acredita ser responsável pela mesma etapa de atualização.
As aplicações alojadas pelos próprios utilizadores iniciam muitas vezes migrações a partir de um ponto de entrada, processo Web, worker, sidecar, unidade systemd ou gancho de implementação. Após uma nova implementação, um contentor antigo pode sobrepor-se a um novo, uma política de reinício pode voltar a iniciar um migrador que falhou ou duas réplicas podem aceder à base de dados antes de uma delas registar a conclusão. O diagnóstico deve identificar todos os potenciais responsáveis pela execução e confirmar se a estrutura de migração utiliza um bloqueio persistente ou um registo do histórico do esquema, antes de começar qualquer reparação de dados.
Identifique todos os processos que podem iniciar a migração
Procure o comando de migração no ponto de entrada da imagem, no comando do Compose, no comando do worker, na unidade systemd, na tarefa cron, no script de implementação e no registo de arranque da aplicação. Registe os IDs dos processos e os nomes dos contentores nos dois momentos de execução.
O Docker Compose pode iniciar os serviços de acordo com as dependências declaradas, mas a ordem de arranque, por si só, não garante que apenas um processo seja responsável pela migração ao nível da aplicação. A orientação oficial sobre a ordem de arranque mostra por que razão a disponibilidade da base de dados e a atribuição exclusiva da migração são condições distintas.
Se o mesmo comando aparecer tanto no ponto de entrada da aplicação Web como num serviço de migração dedicado, remova um dos responsáveis pela sua execução. Se existir apenas um comando, continue a verificar as réplicas, os ciclos de reinício e os registos do estado da migração.
Verifique se há contentores antigos e novos em simultâneo
Durante a implementação, liste os contentores em execução, a reiniciar, terminados e órfãos. Compare os nomes dos projetos, os nomes dos serviços, os IDs dos contentores e os carimbos de data/hora de criação.
A documentação do systemd explica que a política de reinício de um serviço pode voltar a executar um comando que falhou, de acordo com as definições da unidade. O modelo de reinício dos serviços ajuda a explicar por que razão um lançador no anfitrião pode voltar a executar a migração depois de a tentativa no contentor terminar com um código de saída diferente de zero.
Remova apenas as execuções comprovadamente órfãs depois de guardar os respetivos registos. Um segundo carimbo temporal de migração pouco depois do primeiro costuma indicar uma nova tentativa, não uma tarefa agendada separadamente.
Utilize um bloqueio da base de dados antes de aplicar alterações ao esquema
Determine se a aplicação adquire um bloqueio ao nível da base de dados antes de ler o estado das migrações e aplicar alterações. Teste duas tentativas de arranque simultâneas num ambiente descartável.
O PostgreSQL disponibiliza bloqueios consultivos para coordenação definida pela aplicação, permitindo que uma execução de migração exclua outra, mesmo quando ambas começam quase ao mesmo tempo.
Um bloqueio tem de abranger todo o intervalo de decisão e execução. Verificar a versão atual do esquema antes de adquirir o bloqueio permite que duas execuções escolham a mesma migração pendente.
Verifique a semântica dos bloqueios no MySQL ou no MariaDB
Nas aplicações compatíveis com MySQL, verifique se a ferramenta de migração utiliza um bloqueio nomeado, uma transação ou uma tabela de bloqueios e se a ligação permanece ativa durante toda a migração.
O MySQL documenta bloqueios nomeados associados à ligação, que são libertados quando a sessão proprietária termina e, por isso, têm de ser readquiridos de forma segura após uma falha ou um reinício.
Uma ligação interrompida pode libertar o bloqueio antes de a framework de migrações registar a conclusão. Compare os registos da base de dados com os carimbos temporais de reinício dos contentores para identificar esta sequência.
Inspecione a tabela de histórico da framework de migrações
Apresente os identificadores das migrações, a ordem de execução, os indicadores de sucesso, as somas de verificação e os carimbos temporais. Compare as duas execuções registadas com os registos efetivamente confirmados na base de dados.
O Flyway utiliza uma tabela de histórico do esquema para registar as migrações aplicadas e os respetivos estados.
Se a primeira execução alterou o esquema, mas falhou antes de registar o sucesso, a segunda execução pode tentar novamente uma migração que não foi concebida para ser idempotente. Repare o histórico apenas depois de comparar o esquema real com o resultado esperado da migração.
Verifique as alterações na identidade do changelog e nas somas de verificação
Compare os nomes dos ficheiros de migração, os IDs, os autores, os caminhos e as somas de verificação antes e depois da atualização da imagem. Determine se a imagem contém entradas de changelog duplicadas ou renomeadas.
O Liquibase regista as alterações executadas na tabela DATABASECHANGELOG, onde a identidade de cada alteração depende do ID, do autor e do caminho do ficheiro.
Mover um ficheiro de changelog ou gerar identificadores novamente pode fazer com que trabalho antigo pareça novo, mesmo quando o SQL é semelhante. Restaure a identidade estável da migração em vez de eliminar manualmente intervalos amplos do histórico.
Volte a implementar com um único responsável pelas migrações e verifique a idempotência
Escolha um único responsável pelas migrações, adicione bloqueios persistentes, mantenha os serviços Web e de trabalho à espera da conclusão bem-sucedida e volte a implementar numa cópia de teste da base de dados.
O artigo da ZimaSpace sobre limites de agendamento de contentores apresenta a regra complementar: cada tarefa de manutenção deve ter um único responsável comprovado em tempo de execução.
O problema está resolvido quando arranques simultâneos ou repetidos resultam numa única migração aplicada, num único registo permanente no histórico e em nenhuma segunda alteração do esquema após o reinício.
Perguntas frequentes
Executar uma migração duas vezes danifica sempre a base de dados?
Não. As migrações idempotentes podem detetar com segurança objetos existentes, mas as transformações de dados não idempotentes, a criação de índices ou as alterações de colunas podem falhar ou duplicar dados.
Todas as réplicas Web devem poder executar migrações?
Só quando a framework oferece uma coordenação fiável ao nível da base de dados. Numa implementação de servidor doméstico, é mais fácil auditar um responsável dedicado por executar cada migração uma única vez.
Posso marcar manualmente a migração como concluída?
Só depois de confirmar que o esquema e os dados em produção correspondem ao resultado esperado da migração. Alterar o histórico primeiro pode ocultar uma alteração aplicada parcialmente.
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...



