Configurer les ressources pour la migration
Cette page décrit la partie préparatoire du processus de migration au cours de laquelle vous configurez les ressources pour la migration.
À ce stade, vous procédez comme suit :
- Installez les outils de ligne de commande requis pour exécuter des commandes lors des étapes ultérieures du processus de migration.
- Configurez Firestore compatible avec MongoDB.
- (Facultatif) Ajustez les paramètres du journal des opérations (oplog) sur votre source compatible avec MongoDB.
- Créez un bucket Cloud Storage pour le stockage des données intermédiaires.
Configurer les autorisations IAM
Votre compte nécessite les rôles IAM appropriés dans tous les services utilisés lors du processus de migration :
Installer les outils de ligne de commande
La procédure de migration utilise la gcloud CLI pour configurer et exécuter les étapes de la migration. Si nécessaire, installez la gcloud CLI en suivant les instructions de la page Installer la gcloud CLI.
Configuration spécifique à la source
MongoDB sur Compute Engine
Une base de données MongoDB qui s'exécute sur des VM Compute Engine dans un cluster autogéré n'est normalement pas exposée à l'Internet public. La procédure de migration utilisera Private Service Connect dans Datastream pour connecter le pipeline Datastream à votre base de données source.
Procédez comme suit :
Configurez la connectivité privée Datastream en suivant les instructions décrites dans Créer une configuration de connectivité privée.
Notez le paramètre
Configuration IDde la configuration créée. Vous l'utiliserez lors des étapes ultérieures pour configurer les variables d'environnement requises.
Azure Cosmos DB
Assurez-vous qu' Azure CLI est installé sur votre ordinateur.
Amazon DocumentDB
Les clusters Amazon DocumentDB ne sont pas directement accessibles depuis l'extérieur du réseau Amazon VPC. Pour vous connecter à un cluster DocumentDB, vous devez provisionner une instance EC2 dans le réseau Amazon VPC et l'utiliser comme hôte bastion pour un tunnel SSH.
Consultez le guide du développeur Se connecter à un cluster Amazon DocumentDB depuis l'extérieur d'un Amazon VPC pour obtenir des instructions sur la configuration d'une instance EC2 pour la connectivité externe à DocumentDB.
Pour établir une connexion au cluster DocumentDB, vous devez obtenir la clé SSH privée de l'instance EC2, ainsi que le bundle de certificats approprié pour la région dans laquelle votre cluster est déployé. Consultez la page de ressources Bundles de certificats par région AWS pour télécharger le bundle approprié au format PEM.
Notez que le bundle de certificats contient plusieurs certificats. Vous devez extraire un seul certificat pour configurer une connexion Datastream. Nous vous recommandons de valider manuellement la connectivité DocumentDB pour vous assurer que vous disposez d'une clé SSH et d'un certificat DocumentDB valides à partir du bundle régional. Le guide du développeur DocumentDB fournit des exemples de ligne de commande pour établir une connexion directe depuis l'extérieur du VPC.
Configurer une base de données de destination Firestore compatible avec MongoDB
Assurez-vous que votre projet dispose d'une base de données Firestore compatible avec MongoDB dans laquelle vous migrerez les données de votre base de données Mongo source. Pour en savoir plus sur la création d'une base de données, consultez Créer et gérer des bases de données.
Pour cette migration, nous vous recommandons de créer un nom d'utilisateur et un mot de passe pour la base de données Firestore compatible avec MongoDB à utiliser avec le protocole d'authentification SCRAM-SHA-256. Ce nom d'utilisateur peut être supprimé en toute sécurité une fois la migration terminée. Vous pouvez également choisir de continuer à utiliser ces identifiants pour connecter vos clients Mongo à votre nouvelle base de données Firestore compatible avec MongoDB.
Vous utiliserez le nom de cette base de données Firestore compatible avec MongoDB et les identifiants de l'utilisateur lors des étapes ultérieures.
Ajuster la taille de la fenêtre oplog de la base de données source
Nous vous recommandons d'ajuster la fenêtre oplog de votre base de données Mongo source à trois jours de trafic d'écriture total vers cette base de données. Si le taux de trafic d'écriture dépasse le taux auquel Datastream peut consommer les modifications de votre base de données, cet ajustement empêchera la perte de données.
La valeur devra peut-être être ajustée davantage, en fonction du modèle de trafic et du volume de trafic de pointe. Par exemple, si une semaine de trafic est écrite sur une courte période, Datastream risque de ne pas capturer les modifications de l'oplog assez rapidement avant qu'elles ne sortent de la fenêtre oplog. Dans ce cas, vous devrez peut-être redimensionner la fenêtre oplog à sept jours de trafic d'écriture total.
Créer un bucket Cloud Storage
Créez un bucket Cloud Storage comme suit :
Choisissez une région Cloud Storage dans laquelle le pipeline de migration s'exécutera. Nous vous recommandons d'utiliser la région dans laquelle se trouve votre base de données de destination Firestore compatible avec MongoDB.
Choisissez le nom de ce bucket. Exemple :
mongo-migration-bucket. Vous utiliserez ce nom lors des étapes ultérieures.Créez un bucket Cloud Storage avec le nom et dans la région choisis en suivant les instructions fournies sur la page Créer un bucket de la documentation Cloud Storage.
Étape suivante
Passez à Configurer les variables d'environnement.