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 vai usar o Private Service Connect no Datastream para conectar o pipeline do Datastream ao banco de dados de origem.
Observe o parâmetro Configuration ID da configuração criada. Você vai usá-lo em etapas posteriores para configurar as variáveis de ambiente necessárias.
Azure Cosmos DB
Verifique se a CLI do Azure está instalada no computador.
Amazon DocumentDB
Os clusters do Amazon DocumentDB não são acessíveis diretamente de fora da rede VPC da Amazon. Para se conectar a um cluster do DocumentDB, provisione uma instância do EC2 na rede da Amazon VPC e use essa instância como um Bastion Host para um túnel SSH.
Para estabelecer uma conexão com o cluster do DocumentDB, é necessário obter 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 baixar o pacote adequado no formato PEM.
O pacote de certificados contém vários certificados. É necessário
extrair um único certificado para configurar uma conexão do Datastream. Recomendamos que você valide a conectividade do DocumentDB manualmente para garantir que tenha uma chave SSH e um certificado do DocumentDB válidos 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 de origem do MongoDB. Para mais informações sobre como criar um banco de dados, consulte Criar e gerenciar bancos de dados.
Para fins desta migração, recomendamos criar um nome de usuário e uma senha para o banco de dados do Firestore com compatibilidade com o MongoDB e usar 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ê vai usar o nome desse banco de dados do Firestore com compatibilidade com o MongoDB e as credenciais do usuário nas etapas posteriores.
Ajustar o tamanho da janela de oplog do banco de dados de origem
Recomendamos ajustar a janela de oplog do banco de dados Mongo de origem para 3 dias de tráfego total de gravação 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 seu banco de dados, esse ajuste vai evitar a perda de dados.
O valor pode precisar de mais ajustes, 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 talvez não capture as mudanças do oplog com rapidez suficiente antes que elas saiam da janela do oplog. Nesse caso, talvez seja necessário redimensionar a janela do oplog para 7 dias de tráfego total de gravação.
Criar um bucket do Cloud Storage
Crie um 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 do bucket. Exemplo: mongo-migration-bucket. Você vai usar esse nome nas etapas posteriores.
Crie um bucket do Cloud Storage com o nome e na região escolhidos seguindo as instruções da página Criar um bucket na documentação do Cloud Storage.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# Configure resources for migration\n=================================\n\nThis page describes the preparation part of the\n[migration process](/firestore/mongodb-compatibility/docs/migrate-data)\nwhere you configure resources for the migration.\n\nAt this stage, you do the following:\n\n1. Install command-line tools required for running commands at later stages of the migration process.\n2. Configure Firestore with MongoDB compatibility database.\n3. (Optional) Adjust the operation log (oplog) settings on your MongoDB compatible source.\n4. Create a Cloud Storage bucket for intermediate data storage.\n\nConfigure IAM permissions\n-------------------------\n\nYour account requires appropriate IAM roles in all\nservices used in the migration process:\n\n- [Datastream roles](/iam/docs/roles-permissions/datastream)\n- [Dataflow roles](/dataflow/docs/concepts/access-control)\n- [Cloud Storage roles](/storage/docs/access-control/iam-roles)\n- [Datastore roles](/datastore/docs/access/iam)\n\nInstall command-line tools\n--------------------------\n\nThe migration procedure uses the gcloud CLI to configure and\nactuate the migration steps. If required, install the gcloud CLI by\nfollowing instructions on the [Install the gcloud CLI](/sdk/docs/install) page.\n\nSource-specific configuration\n-----------------------------\n\n### MongoDB on Compute Engine\n\nA MongoDB database that runs on Compute Engine VMs in a self-managed\ncluster isn't normally exposed to the public internet. The migration\nprocedure will use\n[Private Service Connect in Datastream](/datastream/docs/psc-interfaces)\nto connect the Datastream pipeline to your source database.\n\nDo the following:\n\n1. Configure Datastream Private Connectivity by following\n instructions outlined in\n [Create a private connectivity configuration](/datastream/docs/create-a-private-connectivity-configuration#create-the-configuration).\n\n2. Note the `Configuration ID` parameter of the created configuration. You\n will use it in later stages to set up required environment variables.\n\n### Azure Cosmos DB\n\nMake sure that\n[Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest)\nis installed on your computer.\n\n### Amazon DocumentDB\n\nAmazon DocumentDB clusters are not directly accessible from outside the Amazon\nVPC network. To connect to a DocumentDB cluster you will have to provision\nan EC2 instance within the Amazon VPC network, and use that instance as a\n[Bastion Host](https://en.wikipedia.org/wiki/Bastion_host) for an SSH tunnel.\n\nVisit the [Connecting to an Amazon DocumentDB cluster from outside an Amazon VPC](https://docs.aws.amazon.com/documentdb/latest/developerguide/connect-from-outside-a-vpc.html) developer guide for instructions on setting\nup an EC2 instance for external connectivity to DocumentDB.\n\nTo establish a connection to the DocumentDB cluster you will have to obtain\nthe private SSH key for the EC2 instance as well as the appropriate\nCertificate Bundle for the region in which your cluster is deployed. Visit the\n[Certificate bundles by AWS Region](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html#UsingWithRDS.SSL.CertificatesAllRegions)\nresource page to download the appropriate bundle in PEM format.\n\nNote that the Certificate Bundle contains multiple certificates. You have to\nextract a single certificate to set up the a Datastream connection. It is\nrecommended that you validate the DocumentDB connectivity manually to ensure\nthat you have both a valid SSH key and a valid DocumentDB certificate from\nthe regional bundle. The DocumentDB [developer guide](https://docs.aws.amazon.com/documentdb/latest/developerguide/connect-from-outside-a-vpc.html) provides commandline examples for establish a direct connection from outside\nthe VPC.\n\nConfigure a destination Firestore with MongoDB compatibility database\n---------------------------------------------------------------------\n\n1. Make sure that your project has a Firestore with MongoDB\n compatibility database where you will migrate data\n from your source Mongo database. For more information about creating a\n database, see\n [Create and manage databases](/firestore/mongodb-compatibility/docs/create-databases).\n\n2. For the purpose of this migration, we recommend to\n [create a username and password](/firestore/mongodb-compatibility/docs/connect#scram)\n for the Firestore with MongoDB compatibility database to\n use with the SCRAM-SHA-256 authentication protocol. This username can be\n safely deleted after the migration completes, or you may choose to keep\n using these credentials to connect your Mongo clients to your new\n Firestore with MongoDB compatibility database.\n\nYou will use the name of this Firestore with MongoDB\ncompatibility database and the user credentials in later steps.\n\nAdjust the oplog window size of the source database\n---------------------------------------------------\n\nWe recommend to adjust the oplog window of your source Mongo database to 3 days\nworth of total write traffic to this database. If the rate of write traffic\nexceeds the rate at which Datastream can consume changes from\nyour database, this adjustment will prevent data loss.\n\nThe value might need to be adjusted further, depending on the pattern of the\ntraffic and the volume of peak traffic. For example, if a week's worth of\ntraffic is written in a short period of time, then Datastream\nmight not capture the changes from the oplog fast enough before changes fall\nout of the oplog window. In this case you might need to resize the oplog window\nto 7 days worth of total write traffic.\n\nCreate a Cloud Storage bucket\n-----------------------------\n\nCreate a new Cloud Storage bucket in the following way:\n\n1. Choose a [Cloud Storage region](/storage/docs/locations) where the\n migration pipeline will run. We recommend to use the region where your\n destination Firestore with MongoDB compatibility database\n is located.\n\n2. Choose the name for this bucket. Example: `mongo-migration-bucket`. You will\n use this name in later steps.\n\n3. Create a new Cloud Storage bucket with the chosen name and in the\n chosen region by following instructions provided on the\n [Create a bucket](/storage/docs/creating-buckets#create-bucket) page in\n the Cloud Storage documentation.\n\nWhat's next\n-----------\n\nProceed to\n[Configure environment variables](/firestore/mongodb-compatibility/docs/migrate-configure-env-vars)."]]
