Promover um job de migração

Para migrações contínuas, é possível iniciar o processo de promoção quando você estiver pronto para transferir os aplicativos para os bancos de dados de destino. A promoção do job de migração desconecta o cluster de destino do AlloyDB para PostgreSQL da origem e o transforma em um cluster principal independente, para que você possa direcionar o tráfego do aplicativo para o cluster.

  1. Interrompa todas as gravações, scripts em execução e conexões de clientes com o banco de dados de origem. A janela de inatividade da transição começa aqui.
  2. Aguarde até que a métrica de atraso de replicação esteja em zero ou próxima de zero. Isso garante que o job de migração tenha processado todas as alterações pendentes da origem.

    É possível promover uma migração mesmo que o atraso de replicação não esteja em zero. Isso pode reduzir o tempo de transição do banco de dados, mas pode afetar a atualização dos dados no destino.

  3. Execute a ação de promoção:

    Console

    1. No console do Google Cloud , acesse a página Jobs de migração.

      Acessar Jobs de migração

    2. Na guia Jobs, clique no nome de exibição do job de migração que você quer promover.

      A página de detalhes do job de migração é aberta.

    3. Na barra de ferramentas do job de migração, clique em Promover.

      A caixa de diálogo de promoção do job de migração é exibida.

    4. Na caixa de diálogo, verifique se não há erros e clique em Promover.

    gcloud

    Antes de usar os dados do comando abaixo, faça estas substituições:

    • MIGRATION_JOB_ID pelo identificador do job de migração.

      Se você não souber o identificador, use o comando gcloud database-migration migration-jobs list para listar todos os jobs de migração em uma determinada região e ver os identificadores deles.

    • REGION pelo identificador da região em que o job de migração está salvo.

    Execute o seguinte comando:

    Linux, macOS ou Cloud Shell

    gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

    Windows (PowerShell)

    gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

    Windows (cmd.exe)

    gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

    Resultado

    A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração: 

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: promote
name: OPERATION_ID

    Para ver se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique o status do job de migração:

  4. O cluster de destino do AlloyDB para PostgreSQL é promovido. O cluster de destino é desconectado da origem, se torna um cluster principal independente e está pronto para receber todo o tráfego do aplicativo. O status do job de migração muda para Completed.
  5. (Opcional) Reinstale as extensões: se o banco de dados de origem usou extensões que não são migradas pelo Database Migration Service (como pg_cron), reinstale e configure essas extensões no cluster de destino.
  6. Agora é possível conectar seus aplicativos ao cluster do AlloyDB para PostgreSQL e excluir o job de migração concluído.