Configure recursos para a migração

Esta página descreve a parte de preparação do processo de migração em que configura os recursos para a migração.

Nesta fase, faz o seguinte:

  1. Instale as ferramentas de linha de comandos necessárias para executar comandos em fases posteriores do processo de migração.
  2. Configure o Firestore com uma base de dados compatível com o MongoDB.
  3. (Opcional) Ajuste as definições do registo de operações (oplog) na sua origem compatível com o MongoDB.
  4. Crie um contentor do Cloud Storage para o armazenamento de dados intermédios.

Configure as autorizações de IAM

A sua conta requer funções de IAM adequadas em todos os serviços usados no processo de migração:

Instale ferramentas de linha de comandos

O procedimento de migração usa a CLI gcloud para configurar e acionar os passos de migração. Se necessário, instale a CLI gcloud seguindo as instruções na página Instale a CLI gcloud.

Configuração específica da origem

MongoDB no Compute Engine

Normalmente, uma base de dados MongoDB executada em VMs do Compute Engine num cluster autogerido não é exposta à Internet pública. O procedimento de migração vai usar o Private Service Connect no Datastream para ligar o pipeline do Datastream à sua base de dados de origem.

Faça o seguinte:

  1. Configure a conetividade privada do fluxo de dados seguindo as instruções descritas no artigo Crie uma configuração de conetividade privada.

  2. Anote o parâmetro Configuration ID da configuração criada. Vai usá-lo em fases posteriores para configurar as variáveis de ambiente necessárias.

Azure Cosmos DB

Certifique-se de que o Azure CLI está instalado no seu computador.

Amazon DocumentDB

Os clusters do Amazon DocumentDB não são diretamente acessíveis a partir de fora da rede da Amazon VPC. Para estabelecer ligação a um cluster do DocumentDB, tem de aprovisionar uma instância do EC2 na rede da VPC da Amazon e usar essa instância como um anfitrião de bastion para um túnel SSH.

Visite o guia para programadores Estabelecer ligação a um cluster do Amazon DocumentDB a partir do exterior de uma Amazon VPC para obter instruções sobre a configuração de uma instância do EC2 para a conetividade externa ao DocumentDB.

Para estabelecer uma ligação ao cluster do DocumentDB, tem de obter a chave SSH privada para a instância do EC2, bem como o conjunto de certificados adequado para a região na qual o cluster está implementado. Visite a página de recursos Pacotes de certificados por região da AWS para transferir o pacote adequado no formato PEM.

Tenha em atenção que o pacote de certificados contém vários certificados. Tem de extrair um único certificado para configurar uma ligação da stream de dados. Recomendamos que valide a conetividade do DocumentDB manualmente para garantir que tem uma chave SSH válida e um certificado DocumentDB válido do pacote regional. O guia do programador do DocumentDB fornece exemplos de linhas de comandos para estabelecer uma ligação direta a partir do exterior da VPC.

Configure um Firestore de destino com uma base de dados compatível com o MongoDB

  1. Certifique-se de que o seu projeto tem uma base de dados do Firestore com compatibilidade com o MongoDB para onde vai migrar os dados da base de dados do MongoDB de origem. Para mais informações sobre como criar uma base de dados, consulte o artigo Crie e faça a gestão de bases de dados.

  2. Para efeitos desta migração, recomendamos que crie um nome de utilizador e uma palavra-passe para a base de dados do Firestore com compatibilidade com o MongoDB para utilização com o protocolo de autenticação SCRAM-SHA-256. Este nome de utilizador pode ser eliminado em segurança após a conclusão da migração ou pode optar por continuar a usar estas credenciais para ligar os seus clientes do Mongo à sua nova base de dados do Firestore com compatibilidade com o MongoDB.

Vai usar o nome desta base de dados compatível com o Firestore com o MongoDB e as credenciais do utilizador nos passos posteriores.

Ajuste o tamanho da janela do oplog da base de dados de origem

Recomendamos que ajuste a janela do oplog da base de dados Mongo de origem para 3 dias de tráfego de gravação total para esta base de dados. Se a taxa de tráfego de gravação exceder a taxa à qual o Datastream pode consumir alterações da sua base de dados, este ajuste evita a perda de dados.

Pode ser necessário ajustar ainda mais o valor, consoante o padrão do tráfego e o volume de tráfego de pico. Por exemplo, se o tráfego de uma semana for escrito num curto período de tempo, o Datastream pode não captar as alterações do oplog com rapidez suficiente antes que as alterações fiquem fora do período do oplog. Neste caso, pode ter de redimensionar a janela do oplog para 7 dias de tráfego de gravação total.

Crie um contentor do Cloud Storage

Crie um novo contentor do Cloud Storage da seguinte forma:

  1. Escolha uma região do Cloud Storage onde o pipeline de migração vai ser executado. Recomendamos que use a região onde se encontra a sua base de dados de destino do Firestore com compatibilidade com o MongoDB.

  2. Escolha o nome deste contentor. Exemplo: mongo-migration-bucket. Vai usar este nome nos passos seguintes.

  3. Crie um novo contentor do Cloud Storage com o nome escolhido e na região escolhida seguindo as instruções fornecidas na página Criar um contentor na documentação do Cloud Storage.

O que se segue?

Continue para Configurar variáveis de ambiente.