Como separar as migrações da base de dados do arranque da aplicação durante a implementação de contentores

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.

É mais fácil evitar migrações duplicadas da base de dados quando as alterações ao esquema são executadas como uma única etapa explícita da implementação, em vez de serem realizadas no arranque de cada contentor da aplicação.

A abordagem preventiva consiste em atribuir às migrações um único responsável, um único conjunto de credenciais e um único sinal de conclusão, antes de as novas réplicas começarem a servir tráfego. Permita que os contentores web e de trabalho reiniciem sem obter privilégios para alterar o esquema, faça com que a implementação aguarde por uma tarefa de migração bem-sucedida e conceba as alterações ao esquema de forma a permitir que as versões antiga e nova da aplicação coexistam temporariamente. Assim, elimina a condição de corrida, em vez de simplesmente esperar que todas as réplicas consultem primeiro o mesmo histórico de migrações.

Remova os Comandos de Migração do Arranque Normal da Aplicação

Inspecione o ponto de entrada da imagem, o comando do Compose, o comando do processo de trabalho, o invólucro de verificação de funcionamento e o script de implementação à procura de chamadas automáticas de migração. A aplicação deve poder reiniciar sem alterar o esquema, a menos que esse reinício seja a etapa de migração deliberadamente escolhida.

Um artigo da Octopus sobre implementações defende que as migrações precisam de um ciclo de vida separado, em vez de estarem associadas ao arranque de cada processo de microsserviço.

Mantenha o binário de migração disponível onde for necessário, mas não o invoque tanto no ponto de entrada da aplicação como numa segunda tarefa. É mais fácil auditar um único responsável explícito do que vários percursos de arranque que dependem todos dos mecanismos de bloqueio da framework.

Execute uma Tarefa de Migração Antes da Implementação

Crie uma tarefa de execução única que utilize os mesmos ficheiros de migração da versão e só termine com sucesso quando a base de dados de destino atingir o estado de esquema esperado. Faça com que a implementação da aplicação dependa desse resultado.

Um guia de implementação atual mostra como uma tarefa é executada antes do lançamento, em vez de permitir que todas as réplicas concorram no arranque.

Não escale a tarefa de migração como o serviço da aplicação. A tarefa deve ter um único responsável pela execução por base de dados de destino, um tempo limite definido, registos e um estado de falha claro que bloqueie a nova versão da aplicação.

Impeça o Arranque da Aplicação Até a Migração Ser Bem-sucedida

Mantenha os novos contentores web e de trabalho à espera até a fase de migração indicar sucesso, mas não faça com que cada contentor em espera volte a executar a migração. A dependência é do resultado, não da repetição da alteração do esquema.

O padrão de implementação de Andrew Lock utiliza pods da aplicação aguardam pela migração, enquanto a lógica de migração permanece centralizada.

Numa pequena infraestrutura de servidor doméstico, o mesmo princípio pode ser implementado com um serviço Compose dedicado e um script de implementação controlado. Mantenha o mecanismo simples o suficiente para que uma migração falhada interrompa visivelmente a implementação.

Use alterações ao esquema compatíveis com versões anteriores durante o período de sobreposição

As implementações graduais podem executar temporariamente versões antigas e novas da aplicação contra a mesma base de dados. Evite uma migração que remova ou mude o nome de um campo antes de a versão antiga deixar de o utilizar.

Um guia recente sobre migrações sem indisponibilidade recomenda expandir antes de contrair, para que as alterações aditivas ao esquema sejam implementadas antes da limpeza destrutiva.

Quando necessário, divida as alterações de grandes dimensões nas fases de expansão, preenchimento retroativo, comutação e contração. A tarefa de migração não deve criar um esquema que apenas o novo contentor compreenda enquanto as réplicas antigas ainda estão a receber pedidos.

Mantenha as credenciais de migração fora das réplicas da aplicação

Sempre que possível, use uma conta de base de dados com privilégios para alterar o esquema apenas na etapa de migração, executada uma única vez. Os contentores normais da aplicação devem manter as permissões mais restritas de leitura e escrita necessárias para os dados da aplicação.

Um artigo sobre implementações com Liquibase descreve que as alterações à base de dados devem fazer parte da automatização, com aplicação controlada e repetível das alterações.

Esta separação reduz a probabilidade de uma execução acidental de migrações, mesmo que um processo da aplicação seja reiniciado ou duplicado. Guarde a credencial com privilégios elevados nos segredos da implementação, em vez de a incluir no ambiente normal do serviço de execução prolongada.

Verifique se a implementação não consegue aplicar o lote duas vezes

Teste a implementação numa base de dados descartável ou numa cópia de segurança restaurada, iniciando várias réplicas da aplicação, reiniciando-as e executando novamente o comando de implementação. A etapa de migração deve indicar o estado atual do esquema sem o alterar uma segunda vez.

A JetBrains resume a regra operacional como executar migrações como etapa da implementação antes do arranque normal da aplicação.

A política de prevenção está completa quando os reinícios da aplicação não conseguem alterar o esquema, uma migração falhada impede a publicação e a execução repetida da implementação deixa a base de dados inalterada. O artigo relacionado da ZimaSpace sobre diagnóstico de migrações duplicadas é o procedimento de recuperação caso já tenha ocorrido uma execução duplicada.

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.