Configurar recursos para migração
Esta página descreve a parte de preparação do processo de migração em que você configura recursos para a migração.
Nessa etapa, faça o seguinte:
- Instale as ferramentas de linha de comando necessárias para executar comandos em etapas posteriores do processo de migração.
- Configure o banco de dados do Firestore com compatibilidade com o MongoDB.
- (Opcional) Ajuste as configurações do registro de operações (oplog) na origem compatível com o MongoDB.
- Crie um bucket do Cloud Storage para armazenamento de dados intermediários.
Configurar as permissões do IAM
Sua conta exige papéis do IAM adequados em todos os serviços usados no processo de migração:
Instalar ferramentas de linha de comando
O procedimento de migração usa a CLI gcloud para configurar e acionar as etapas de migração. Se necessário, instale a CLI gcloud seguindo as instruções na página Instalar a CLI gcloud.
Configuração específica da origem
MongoDB no Compute Engine
Um banco de dados do MongoDB executado em VMs do Compute Engine em um cluster autogerenciado normalmente não é exposto à Internet pública. O procedimento de migração usará o Private Service Connect no Datastream para conectar o pipeline do Datastream ao banco de dados de origem.
Faça o seguinte:
Configure a conectividade privada do Datastream seguindo as instruções descritas em Criar uma configuração de conectividade privada.
Anote o parâmetro
Configuration IDda configuração criada. Você o usará em etapas posteriores para configurar as variáveis de ambiente necessárias.
Azure Cosmos DB
Verifique se a CLI do Azure está instalada no seu computador.
Amazon DocumentDB
Os clusters do Amazon DocumentDB não podem ser acessados diretamente de fora da rede VPC da Amazon. Para se conectar a um cluster do DocumentDB, é necessário provisionar uma instância do EC2 na rede Amazon VPC e usar essa instância como um Bastion Host para um túnel SSH.
Acesse o guia do desenvolvedor Conectar-se a um cluster do Amazon DocumentDB de fora de uma Amazon VPC para instruções sobre como configurar uma instância do EC2 para conectividade externa ao DocumentDB.
Para estabelecer uma conexão com o cluster do DocumentDB, é necessário receber a chave SSH privada da instância do EC2 e o pacote de certificados adequado para a região em que o cluster está implantado. Acesse a página de recursos Pacotes de certificados por região da AWS para fazer o download do pacote adequado no formato PEM.
Observação: o pacote de certificados contém vários certificados. É necessário extrair um único certificado para configurar uma conexão do Datastream. Recomendamos validar a conectividade do DocumentDB manualmente para garantir que você tenha uma chave SSH válida e um certificado do DocumentDB válido do pacote regional. O guia do desenvolvedor do DocumentDB fornece exemplos de linha de comando para estabelecer uma conexão direta de fora da VPC.
Configurar um banco de dados de destino do Firestore com compatibilidade com o MongoDB
Verifique se o projeto tem um banco de dados do Firestore com compatibilidade com o MongoDB para onde você vai migrar os dados do banco de dados do Mongo de origem. Para mais informações sobre como criar um banco de dados, consulte Criar e gerenciar bancos de dados.
Para fins de migração, recomendamos criar um nome de usuário e uma senha para o banco de dados do Firestore com compatibilidade com o MongoDB a ser usado com o protocolo de autenticação SCRAM-SHA-256. Esse nome de usuário pode ser excluído com segurança após a conclusão da migração. Também é possível continuar usando essas credenciais para conectar seus clientes do Mongo ao novo banco de dados do Firestore com compatibilidade com o MongoDB.
Você usará o nome desse banco de dados do Firestore com compatibilidade com o MongoDB e as credenciais do usuário em etapas posteriores.
Ajustar o tamanho da janela do oplog do banco de dados de origem
Recomendamos ajustar a janela do oplog do banco de dados do Mongo de origem para um tráfego de gravação total de três dias nesse banco de dados. Se a taxa de tráfego de gravação exceder a taxa em que o Datastream pode consumir mudanças do banco de dados, esse ajuste vai evitar a perda de dados.
O valor pode precisar ser ajustado ainda mais, dependendo do padrão do tráfego e do volume de tráfego de pico. Por exemplo, se o tráfego de uma semana for gravado em um curto período, o Datastream poderá não capturar as mudanças do oplog com rapidez suficiente antes que as mudanças saiam da janela do oplog. Nesse caso, talvez seja necessário redimensionar a janela do oplog para um tráfego de gravação total de sete dias.
Criar um bucket do Cloud Storage
Crie um novo bucket do Cloud Storage da seguinte maneira:
Escolha uma região do Cloud Storage em que o pipeline de migração será executado. Recomendamos usar a região em que o banco de dados de destino do Firestore com compatibilidade com o MongoDB está localizado.
Escolha o nome desse bucket. Exemplo:
mongo-migration-bucket. Você usará esse nome em etapas posteriores.Crie um bucket do Cloud Storage com o nome e na região escolhidos seguindo as instruções fornecidas na página Criar um bucket na documentação do Cloud Storage.
A seguir
Prossiga para Configurar variáveis de ambiente.