Criar um job de migração para uma nova instância de destino

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

Visão geral

O Database Migration Service usa jobs para migrar dados da instância de banco de dados de origem para a instância de banco de dados de destino do AlloyDB.

Para conectividade de IP particular, ao migrar para um cluster do AlloyDB para PostgreSQL criado com o Database Migration Service, só é possível usar o método de acesso a serviços particulares. Se você quiser usar o Private Service Connect com o cluster de destino, primeiro crie o destino do AlloyDB para PostgreSQL fora do Database Migration Service, e siga o fluxo Migrar para uma instância atual.

A criação de um job de migração inclui:

• Definir configurações para o job de migração
• Especificar informações sobre o perfil de conexão que você criou para seu banco de dados de origem (perfil de conexão de origem)
• Definir configurações para a instância de banco de dados de destino do AlloyDB e criar a instância
• Configurar a conectividade entre as instâncias de banco de dados de origem e destino
• Testar o job de migração para garantir que as informações de conexão fornecidas para o job sejam válidas

O assistente do Database Migration Service ajuda a criar um job de migração. O assistente consiste em vários painéis em que você fornece informações sobre seus bancos de dados de origem, bancos de dados de destino e métodos de conectividade. No assistente, também é possível testar o job de migração antes de terminar de criá-lo. As informações sobre como preencher cada painel são fornecidas nas várias seções desta página.

Definir configurações para o job de migração

1. Acesse a página Jobs de migração no Google Cloud console.
2. Clique em Criar job de migração na parte de cima da página.

3. Forneça um nome para o job de migração.

   Escolha um nome amigável que ajude a identificar o job de migração. Não inclua informações sensíveis ou de identificação pessoal no nome do job.

4. Mantenha o ID do job de migração gerado automaticamente.

5. Selecione o mecanismo de banco de dados de origem.

6. Selecione AlloyDB para PostgreSQL como o mecanismo de destino.

7. Selecione a região de destino para sua migração. É aqui que a instância do Database Migration Service é criada e precisa ser selecionada com base na localização dos serviços que precisam dos seus dados, como instâncias do Compute Engine e apps do App Engine, entre outros serviços. Depois de escolher a região de destino, essa seleção não poderá ser alterada.

8. Escolha Contínuo (snapshot + mudanças contínuas) como o tipo de serviço de migração.

9. Revise os pré-requisitos necessários que são gerados automaticamente para refletir como o ambiente precisa estar preparado para um job de migração. Esses pré-requisitos podem incluir como configurar o banco de dados de origem e como conectá-lo à instância de banco de dados de destino do AlloyDB. É melhor concluir esses pré-requisitos nesta etapa, mas é possível concluí-los a qualquer momento antes de testar ou iniciar o job de migração. Para mais informações sobre esses pré-requisitos, consulte Configurar a origem.

10. Clique em Salvar e continuar.

Especificar informações sobre o perfil de conexão de origem

1. Se você criou um perfil de conexão, selecione-o na lista de perfis de conexão atuais.

   Se você não tiver criado um perfil de conexão, crie um clicando em Criar um perfil de conexão na parte de baixo de a lista suspensa. Depois siga as mesmas etapas de Criar um perfil de conexão de origem.

   Recomendamos criar um perfil de conexão designado para a migração do AlloyDB.

2. Na seção Personalizar configurações de despejo de dados, clique em Mostrar configurações de despejo de dados.

   A velocidade do paralelismo de despejo de dados está relacionada à quantidade de carga no banco de dados de origem. É possível usar as seguintes configurações:

   • Ideal (recomendado): desempenho equilibrado com carga ideal no banco de dados de origem.
   • Máximo: oferece as maiores velocidades de despejo, mas pode causar um aumento da carga no banco de dados de origem.
   • Mínimo: usa a menor quantidade de recursos de computação no banco de dados de origem, mas pode ter uma capacidade de processamento de despejo mais lenta.

   Se você quiser usar configurações de paralelismo de despejo de dados ajustadas, aumente os parâmetros max_replication_slots, max_wal_senders, e max_worker_processes no banco de dados de origem. É possível verificar a configuração executando o teste do job de migração no final da criação do job de migração.

3. Clique em Salvar e continuar.

Se o banco de dados de origem for uma instância do Cloud SQL e tiver apenas o IP público ativado, certifique-se de ativar o IP particular antes de continuar para a próxima seção. Lembre-se de atualizar o perfil de conexão com o IP particular.

Definir e criar a instância de destino do AlloyDB

Agora você vai criar um novo cluster de destino do AlloyDB para o job de migração. Os clusters são os recursos de nível superior no AlloyDB. Eles contêm uma única instância principal para acesso de leitura/gravação ao banco de dados criado durante o processo de migração.

Para criar um cluster de destino:

1. Escolha um tipo de cluster. No momento, o Database Migration Service oferece suporte a clusters do AlloyDB altamente disponíveis. Eles podem veicular dados de mais de uma zona em uma região, sem pools de leitura.
2. Clique em CONTINUAR.
3. Configure o cluster:
   1. No campo ID do cluster, insira um ID para o cluster.
   2. No campo Senha, insira uma senha para o usuário postgres padrão. Você vai precisar da senha para fazer login no banco de dados.
   3. No campo Rede :
      1. Selecione um caminho de rede para definir quais recursos estão disponíveis ao configurar a conectividade de migração. Os clusters só podem ser configurados com um caminho de rede IP particular. Se você planeja se conectar ao banco de dados de origem com o peering de VPC, selecione a VPC em que ele está localizado.
      2. Se a rede não estiver configurada para acesso a serviços particulares, clique em Configurar conexão e siga o assistente de configuração de conexão.
      3. Se uma rede de serviço gerenciado nunca foi configurada para a VPC selecionada, você pode selecionar um intervalo de IP e clicar em Conectar ou usar um intervalo de IP selecionado automaticamente e clicar em Alocar e conectar.
   4. Opcional: na seção Criptografia, especifique se você quer gerenciar a criptografia dos dados migrados da origem para o destino. Por padrão, seus dados são criptografados com uma chave gerenciada por Google Cloud.

      Se você quiser gerenciar a criptografia, use uma chave de criptografia gerenciada pelo cliente (CMEK). A chave precisa estar no mesmo local do cluster do AlloyDB. Por exemplo, clusters localizados em us-west1 só podem usar chaves em us-west1.

      1. Selecione o botão de opção Usar uma chave de criptografia gerenciada pelo cliente (CMEK).
      2. No menu Selecionar uma chave gerenciada pelo cliente, selecione sua CMEK.

      Se você não encontrar sua chave, clique em INSERIR NOME DO RECURSO DA CHAVE para fornecer o nome do recurso da chave que você quer usar. Por exemplo, é possível inserir projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key no campo Nome do recurso da chave e clicar em SALVAR.

      Como parte da criação do job de migração, o Database Migration Service vai verificar se a CMEK existe e se o Database Migration Service tem permissões para usar a chave.

      Se o Database Migration Service não tiver essas permissões, as informações vão aparecer, especificando que a conta de serviço do Database Migration Service não pode usar a CMEK. Clique em CONCEDER para dar permissões ao Database Migration Service para usar a chave.

      Para mais informações sobre chaves de criptografia, consulte Usar a CMEK na documentação do AlloyDB.

   5. Clique em CONTINUAR.
4. Configure a instância principal. Uma instância principal determina a capacidade de computação de um cluster e oferece suporte a operações de leitura e gravação:
1. No campo ID da instância, insira um ID para a instância primária.
2. Selecione um tipo de máquina.
3. Se você planeja usar o método de conectividade da lista de permissões de IP, marque a caixa de seleção Ativar IP público de saída.
4. Opcional: defina flags para sua instância. É possível usar flags para personalizar a instância. Para informações sobre flags compatíveis, consulte a documentação do AlloyDB. Para cada flag:
   1. Clique em ADICIONAR FLAG.
   2. Selecione uma flag na lista Nova flag de banco de dados.
   3. Forneça um valor para a flag.
   4. Clique em CONCLUÍDO.
5. Clique em Salvar e continuar.
6. Confirme sua escolha clicando em CRIAR DESTINO E CONTINUAR.
7. Aguarde a conclusão da criação da instância de destino.

O cluster do AlloyDB estará no estado "Bootstrap" enquanto estiver sendo gerenciado pelo Database Migration Service. Enquanto estiver no "Bootstrap", não será possível realizar operações no cluster. Se você ainda quiser excluir o cluster, faça isso usando a gcloud com a opção --force.

Configurar a conectividade entre as instâncias de banco de dados de origem e destino

Se você estiver reutilizando um perfil de conexão de origem que foi usado anteriormente para migrações heterogêneas (por exemplo, do Oracle para o Cloud SQL PostgreSQL), nesta etapa, escolha um método de conectividade. Esse método será usado para a migração homogênea do banco de dados do Cloud SQL para PostgreSQL para o AlloyDB. É necessário selecionar um método de conectividade porque o método de conectividade heterogêneo não é relevante para esse job de migração.

1. No menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como a instância do AlloyDB recém-criada se conectará ao banco de dados de origem. Os métodos de conectividade de rede atuais incluem lista de permissões de IP, peering de VPC, túnel SSH reverso e proxy TCP por meio de uma VM hospedada na nuvem.

2. Se você selecionar o método de conectividade de rede da lista de permissões de IP, especifique o endereço IP de saída da instância de destino. Copie os endereços IP de saída da instância principal e secundária e use-os para configurar o firewall de rede do servidor de banco de dados de origem e no arquivo pg_hba.conf, para que a origem possa aceitar conexões desses endereços.

3. Se você selecionar o método de conectividade de rede do túnel SSH reverso, selecione a instância de VM do Compute Engine que vai hospedar o túnel.

   Depois de especificar a instância, o Google vai fornecer um script que executa as etapas de configuração do túnel entre os bancos de dados de origem e destino. Será necessário executar o script na Google Cloud CLI.

   Execute os comandos de uma máquina que tenha conectividade com o banco de dados de origem e com o Google Cloud.

4. Se você selecionar o método de conectividade de rede de peering de VPC, selecione a rede VPC em que o banco de dados de origem está localizado. A instância do Cloud SQL será atualizada para se conectar a essa rede.

5. Se você selecionar o método de conectividade do proxy TCP por meio da VM hospedada na nuvem, insira os detalhes necessários para a nova instância de VM do Compute Engine que vai hospedar o proxy TCP.

   Depois de especificar os detalhes, o Google Cloud console vai fornecer um script que executa as etapas de configuração do proxy entre os bancos de dados de origem e destino. Será necessário executar o script em uma máquina com uma Google Cloud CLI atualizada.

   Depois de executar o script, ele vai gerar o IP particular da VM recém-criada. Insira o IP e clique em Configurar e continuar.

6. Saiba como configurar a conectividade.
   Observação: caso a origem seja o Cloud SQL para PostgreSQL, dependendo se a instância de origem do Cloud SQL está na arquitetura de rede antiga ou na nova, as opções de conectividade são limitadas a Peering de VPC e Proxy TCP por meio de uma VM hospedada na nuvem.

7. Depois de selecionar o método de conectividade de rede e fornecer outras informações para o método, clique em CONFIGURAR E CONTINUAR.

Configurar bancos de dados de migração

É possível selecionar os bancos de dados que você quer migrar.

1. Na lista Bancos de dados a serem migrados, selecione uma das seguintes opções:
   • Todos os bancos de dados: seleciona todos os bancos de dados que existem na origem.
   • Bancos de dados específicos: permite selecionar bancos de dados específicos de todos os bancos de dados que existem na origem.

2. Se você quiser migrar bancos de dados específicos, filtre a lista que aparece e selecione os bancos de dados que você quer que o Database Migration Service migre para um destino.

   Se a lista não aparecer e um erro de descoberta de banco de dados for exibido, clique em Recarregar. Se a descoberta do banco de dados falhar, o job vai migrar todos os bancos de dados. É possível continuar criando um job de migração e corrigir erros de conectividade mais tarde.

3. Clique em Salvar e continuar.

Testar e criar o job de migração

Nesta etapa final, revise o resumo das configurações do job de migração, da origem, do destino e do método de conectividade e teste a validade da configuração do job de migração. Se houver problemas, modifique as configurações do job de migração. Nem todas as configurações podem ser editadas.

1. Clique em TESTAR JOB para verificar se:

   • O banco de dados de origem foi configurado corretamente, com base nos pré-requisitos.
   • As instâncias de origem e destino podem se comunicar.
   • Todas as atualizações necessárias nos endereços IP particulares no destino foram feitas.

   • O job de migração é válido e as versões de origem e destino são compatíveis.

   Se o teste falhar, resolva o problema na parte apropriada do fluxo e retorne para testar novamente.

   Para mais informações sobre os motivos pelos quais o teste pode falhar e como resolver problemas associados à falha do teste, consulte Diagnosticar problemas do AlloyDB.

   O job de migração pode ser criado mesmo que o teste falhe, mas, depois que o job for iniciado, ele poderá falhar em algum momento durante a execução.

2. Clique em CRIAR E INICIAR JOB para criar o job de migração e iniciá-lo imediatamente ou clique em CRIAR JOB para criar o job de migração sem iniciá-lo imediatamente.

   Se o job não for iniciado no momento da criação, ele poderá ser iniciado na página Jobs de migração clicando em INICIAR.

   Independentemente de quando o job de migração for iniciado, sua organização será cobrada pela existência da instância de destino.

   Ponto principal:quando você inicia o job de migração, o Database Migration Service começa o despejo completo, bloqueando brevemente o banco de dados de origem. Se a origem estiver no Amazon RDS ou no Amazon Aurora, o Database Migration Service também exigirá um período curto de inatividade na gravação (aproximadamente menos de um minuto) no início da migração.

   Para mais informações, consulte Limitações conhecidas.

3. O job de migração é adicionado à lista de jobs de migração e pode ser visualizado diretamente.