Créer un job de migration vers une nouvelle instance de destination

MySQL   |  PostgreSQL   |  PostgreSQL vers AlloyDB

Présentation

Database Migration Service utilise des jobs de migration pour migrer des données de votre instance de base de données source vers l'instance de base de données Cloud SQL de destination.

Remarque : Pour la connectivité IP, lorsque vous effectuez une migration vers une instance Cloud SQL créée avec Database Migration Service, vous ne pouvez utiliser que la méthode d'accès aux services privés (appairage de VPC). Si vous souhaitez utiliser Private Service Connect avec votre cluster de destination, créez d'abord l'instance de destination directement dans Cloud SQL, puis suivez les étapes de la page Migrer vers une instance existante.

La création d'un job de migration comprend les étapes suivantes :

• Définir les paramètres du job de migration
• Spécifier des informations sur le profil de connexion que vous avez créé pour votre base de données source (profil de connexion source)
• Définir les paramètres de l'instance de base de données Cloud SQL de destination et créer l'instance
• Configurer la connectivité entre les instances de base de données source et de destination
• Tester le job de migration pour vous assurer que les informations de connexion fournies pour le job sont valides

L'assistant Database Migration Service vous aide à créer un job de migration. Il comporte plusieurs volets dans lesquels vous fournissez des informations sur vos bases de données source et de destination, ainsi que sur les méthodes de connectivité. Dans l'assistant, vous pouvez également tester votre job de migration avant de terminer sa création. Des informations sur la façon de remplir chaque volet sont fournies dans les différentes sections de cette page.

Définir les paramètres du job de migration

1. Accédez à la page Jobs de migration dans la Google Cloud console.
2. Cliquez sur Créer un job de migration en haut de la page.

3. Indiquez un nom pour le job de migration.

   Choisissez un nom convivial qui vous aidera à identifier le job de migration. N'incluez pas d'informations sensibles ni d'informations permettant d'identifier personnellement une personne dans le nom du job.

4. Conservez l'ID de job de migration généré automatiquement.

5. Sélectionnez le moteur de base de données source.

6. Sélectionnez le moteur de base de données de destination.

7. Sélectionnez la destination région pour votre migration. C'est là que l'instance Database Migration Service est créée. Vous devez la sélectionner en fonction de l'emplacement des services qui ont besoin de vos données, tels que les instances Compute Engine, les applications App Engine et d'autres services. Une fois que vous avez choisi la région de destination, vous ne pouvez plus modifier cette sélection.

   Important : Si vous prévoyez d'utiliser l'édition Cloud SQL pour PostgreSQL Enterprise Plus, assurez-vous que votre région est compatible avec cette édition. Consultez la section Compatibilité régionale de l'édition Enterprise Plus de Cloud SQL pour PostgreSQL.

8. Spécifiez le type de job de migration : Ponctuel (instantané uniquement) ou Continu (instantané + modifications en cours).

9. Passez en revue les conditions préalables générées automatiquement, qui reflètent la façon dont l'environnement doit être préparé pour un job de migration. Ces conditions préalables peuvent inclure la configuration de la base de données source et la connexion à l'instance de base de données Cloud SQL de destination. Il est préférable d'appliquer ces conditions préalables dès la présente étape, mais vous pouvez le faire à tout moment avant de tester le job de migration ou de le démarrer. Pour en savoir plus sur ces conditions préalables, consultez la section Configurer votre source.

10. Cliquez sur Enregistrer et continuer.

Spécifier des informations sur le profil de connexion source

1. Si vous avez créé un profil de connexion, sélectionnez-le dans la liste des profils de connexion existants.

   Si vous n'avez pas créé de profil de connexion, créez-en un en cliquant sur Créer un profil de connexion en bas de la liste déroulante, puis suivez la même procédure que dans Créer un profil de connexion source.

2. Dans la section Personnaliser les configurations de vidage de données, cliquez sur Afficher les configurations de vidage de données.

   La vitesse du parallélisme du vidage de données est liée à la charge de votre base de données source. Vous pouvez utiliser les paramètres suivants :

   • Optimal (recommandé) : performances équilibrées avec une charge optimale sur la base de données source.
   • Maximum : offre les vitesses de vidage les plus élevées, mais peut entraîner une charge accrue sur la base de données source.
   • Minimum : utilise la plus faible quantité de ressources de calcul sur la base de données source, mais peut avoir un débit de vidage plus lent.

   Si vous souhaitez utiliser des paramètres de parallélisme de vidage de données ajustés, veillez à augmenter les paramètres max_replication_slots, max_wal_senders, et max_worker_processes sur votre base de données source. Vous pouvez vérifier votre configuration en exécutant le test du job de migration à la fin de la création du job de migration.

3. Cliquez sur Enregistrer et continuer.

Définir et créer l'instance Cloud SQL de destination

Remarque : Pour les sources Cloud SQL : si vous effectuez une migration depuis une instance Cloud SQL qui utilise une connexion IP privée vers une instance Cloud SQL qui utilise une plage d'adresses IP non-RFC 1918, ajoutez la plage non-RFC 1918 à la configuration réseau de votre instance Cloud SQL source. Consultez la section Configurer des réseaux autorisés dans la documentation Cloud SQL.

1. Dans le menu déroulant Type d'instance de destination, sélectionnez Nouvelle instance.

   Vous pouvez également effectuer une migration vers une instance existante. Consultez la section Job de migration pour une instance existante.

2. Indiquez un ID pour l'instance Cloud SQL ou utilisez l'ID généré automatiquement. N'incluez pas d'informations sensibles ni d'informations permettant d'identifier personnellement une personne dans le ID, car il est visible de l'extérieur. Il n'est pas nécessaire d'inclure l'ID de projet dans le nom de l'instance. Cela se fait automatiquement le cas échéant (par exemple, dans les fichiers journaux).

3. Indiquez un mot de passe alphanumérique pour l'instance Cloud SQL de destination. Il s'agit du mot de passe du compte administrateur postgres dans l'instance.

   Vous pouvez saisir le mot de passe manuellement ou cliquer sur Générer pour que Database Migration Service en crée un automatiquement.

4. Choisissez la version de la base de données pour l'instance de destination dans la liste des versions Database Migration Service compatibles avec le moteur de base de données spécifié. En savoir plus sur la compatibilité de la migration entre les versions
5. Sélectionnez l'édition Cloud SQL pour PostgreSQL pour votre instance de destination. Deux options sont disponibles : Cloud SQL pour PostgreSQL Enterprise et Cloud SQL pour PostgreSQL Enterprise Plus.

   Les éditions Cloud SQL pour PostgreSQL sont fournies avec différents ensembles de fonctionnalités, types de machines disponibles et tarifs. Veillez à consulter la documentation Cloud SQL pour choisir l'édition adaptée à vos besoins. Pour en savoir plus, consultez la page Présentation des éditions Cloud SQL pour PostgreSQL.

6. L'instance est créée dans la région que vous avez sélectionnée lorsque vous avez défini les paramètres du job de migration. Sélectionnez une zone dans cette région ou laissez la zone définie sur N'importe quelle pour que Google en sélectionne une automatiquement.

   Si vous configurez votre instance pour la haute disponibilité, sélectionnez Plusieurs zones (haute disponibilité). Vous pouvez sélectionner les zones principale et secondaire. Les conditions suivantes s'appliquent lorsque la zone secondaire est utilisée lors de la création de l'instance :

   • Les zones sont définies par défaut sur N'importe quelle pour la zone principale et sur N'importe quelle (différente de la principale) pour la zone secondaire.
   • Si les zones principale et secondaire sont spécifiées, elles doivent être distinctes l'une de l'autre.

7. Indiquez si vous souhaitez vous connecter à cette instance avec une adresse IP privée ou publique.
1. Si vous prévoyez de vous connecter avec un appairage de VPC ou un tunnel SSH inversé, cochez la case Adresse IP privée.
1. Assurez-vous que les conditions suivantes sont remplies pour activer l'adresse IP privée :
• L'API Service Networking est activée. Vous pouvez activer l' API Service Networking à l'aide de la Google Cloud console.
• Vous disposez de l'autorisation IAM servicenetworking.services.addPeering.
• Vous avez configuré l'accès aux services privés pour votre projet, pour lequel vous devez disposer du rôle IAM compute.networkAdmin.
• Il existe au moins un réseau VPC non hérité dans votre projet ou un réseau VPC partagé.
• Si vous utilisez un réseau VPC partagé, vous devez également effectuer les opérations suivantes :
  • Activez l'API Service Networking pour le projet hôte.
  • Ajoutez votre utilisateur au projet hôte.
  • Attribuez à votre utilisateur le rôle IAM compute.networkAdmin compute.networkAdmin dans le projet hôte.
2. Sélectionnez le réseau VPC associé à appairer. Si vous prévoyez de vous connecter à la source de migration avec un appairage de VPC, choisissez le VPC où réside l'instance.
3. Si aucun réseau de service géré n'a jamais été configuré pour le VPC sélectionné, vous pouvez choisir de sélectionner une plage d'adresses IP et de cliquer sur Connecter ou d'utiliser une plage d'adresses IP sélectionnée automatiquement et de cliquer sur Allouer et connecter.

2. Si vous prévoyez de vous connecter avec une liste d'autorisation d'adresses IP, sélectionnez Adresse IP publique.

   Si vous le souhaitez, cliquez sur Réseaux autorisés, puis autorisez un réseau ou un proxy à se connecter à l'instance Cloud SQL. Les instances Cloud SQL n'acceptent les connexions que depuis les adresses autorisées. Pour en savoir plus sur la configuration de l'accès public à l'instance, consultez la section Configurer une adresse IP publique.

8. Sélectionnez le type de machine pour l'instance Cloud SQL. La taille du disque doit être supérieure ou égale à la taille de la base de données source.
   Remarque : Les machines disponibles dans la sélection Type de machine dépendent de l'édition Cloud SQL que vous utilisez.

   En savoir plus sur PostgreSQL les types de machines.

9. Pour l'édition Cloud SQL pour PostgreSQL Enterprise Plus : cochez la case Activer le cache de données si vous souhaitez utiliser la fonctionnalité de cache de données dans votre base de données de destination.

   Le cache de données est une fonctionnalité facultative disponible pour les instances Cloud SQL pour PostgreSQL Enterprise Plus qui ajoute un disque SSD local haute vitesse à votre base de données de destination. Cette fonctionnalité peut entraîner des coûts supplémentaires pour votre Cloud SQL. Pour en savoir plus sur le cache de données, consultez la section Présentation du cache de données dans la documentation Cloud SQL.

10. Indiquez le type de stockage pour l'instance Cloud SQL. Vous pouvez choisir un disque SSD ou un disque dur HDD.
11. Indiquez la capacité de stockage (en Go) pour l'instance Cloud SQL.
    Important : Assurez-vous que l'instance dispose d'une capacité de stockage suffisante pour gérer les données de votre base de données source. Vous pouvez augmenter cette capacité à tout moment, mais vous ne pouvez pas la réduire.
12. Si vous le souhaitez, cliquez sur AFFICHER LES CONFIGURATIONS FACULTATIVES, puis procédez comme suit :

    1. Indiquez si vous souhaitez gérer le chiffrement des données migrées de la source vers la destination. Par défaut, vos données sont chiffrées avec une clé gérée par Google Cloud. Si vous souhaitez gérer votre chiffrement, vous pouvez utiliser une clé de chiffrement gérée par le client (CMEK). Pour ce faire :

       1. Cochez la case Utiliser une clé de chiffrement gérée par le client (CMEK).
       2. Dans le menu Sélectionner une clé gérée par le client, sélectionnez votre CMEK.

       Si vous ne voyez pas votre clé, cliquez sur SAISIR LE NOM DE RESSOURCE DE LA CLÉ pour fournir le nom de ressource de la clé que vous souhaitez utiliser. Par exemple, vous pouvez saisir projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key dans le champ Nom de ressource de la clé, puis cliquer sur ENREGISTRER.

       Lors de la création du job de migration, Database Migration Service vérifie que la CMEK existe et que Database Migration Service est autorisé à utiliser la clé.

       Si Database Migration Service ne dispose pas de ces autorisations, des informations s'affichent, indiquant que le compte de service Database Migration Service ne peut pas utiliser la CMEK. Cliquez sur ACCORDER pour autoriser Database Migration Service à utiliser la clé.

       Pour en savoir plus sur la création d'une CMEK, consultez la section Utiliser des clés de chiffrement gérées par le client (CMEK).

    2. Ajoutez les options nécessaires qui seront appliquées au serveur de base de données. Si possible, assurez-vous que les options de base de données de l'instance Cloud SQL de destination créée sont identiques à celles de la base de données source. En savoir plus sur les options de base de données compatibles avec PostgreSQL
    3. Ajoutez les étiquettes spécifiques à l'instance Cloud SQL.

       Les libellés vous aident à organiser vos instances. Par exemple, vous pouvez organiser les étiquettes par centre de coûts ou par environnement. Elles sont également incluses dans votre facture, ce qui vous permet de vérifier la répartition des coûts.

    4. Cliquez sur CRÉER ET CONTINUER.

       La création d'instances répliquées avec accès en lecture et l'activation de la haute disponibilité ne sont disponibles qu'après la promotion de la migration.

13. Dans la fenêtre Créer une base de données de destination, cliquez sur CRÉER UNE DESTINATION ET CONTINUER pour créer l'instance. Cette opération peut prendre plusieurs minutes.
    Cela crée une instance Cloud SQL qui vous sera facturée en fonction de la configuration spécifiée. Si vous quittez le flux de création du job de migration avant la fin, utilisez le bouton ANNULER pour nettoyer l'instance Cloud SQL. Si le navigateur ou l'onglet est fermé, si vous cliquez sur Enregistrer et quitter ou si vous quittez l'écran, l'instance Cloud SQL n'est pas nettoyée et vous devrez la supprimer manuellement depuis la page Instances Cloud SQL.
    Une fois l'instance de destination créée, vous ne pouvez plus modifier les paramètres de l'instance Cloud SQL dans la console Database Migration Service. Vous pouvez toujours accéder directement à l'instance dans la console Cloud SQL pour la modifier.
14. Attendez la fin de la création de l'instance de destination.

Configurer la connectivité entre les instances de base de données source et de destination

Si vous réutilisez un profil de connexion source qui a déjà été utilisé pour des migrations hétérogènes (par exemple, d'Oracle vers Cloud SQL pour PostgreSQL), vous devez choisir une méthode de connectivité lors de cette étape. Cette méthode sera utilisée pour la migration homogène d'une instance de base de données Cloud SQL pour PostgreSQL à une autre. Vous devez sélectionner une méthode de connectivité, car la méthode de connectivité hétérogène n'est pas pertinente pour ce job de migration.

1. Dans le menu déroulant Méthode de connectivité, sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont l'instance Cloud SQL créée se connecte à la base de données source. Les méthodes actuelles de connectivité réseau incluent les listes d'autorisation d'adresses IP, les tunnels SSH inversés et l'appairage de VPC.

   • Si vous sélectionnez la méthode de connectivité réseau de liste d'autorisation d'adresses IP, vous devez spécifier l'adresse IP sortante de votre instance de destination. Si l'instance Cloud SQL que vous avez créée est une instance à haute disponibilité, incluez les adresses IP sortantes pour les instances principale et secondaire.

   • Si vous sélectionnez la méthode de connectivité réseau de tunnel SSH inversé, sélectionnez l'instance de VM Compute Engine qui hébergera le tunnel.

     Après avoir spécifié l'instance, Google fournit un script qui effectue les étapes de configuration du tunnel entre les bases de données source et de destination. Vous devrez exécuter le script dans Google Cloud CLI.

     Exécutez les commandes à partir d'une machine connectée à la fois à la base de données source et à Google Cloud.

   • Si vous sélectionnez la méthode de connectivité réseau d'appairage de VPC, sélectionnez le réseau VPC sur lequel réside la base de données source. L'instance Cloud SQL sera mise à jour pour se connecter à ce réseau.
   • Découvrez comment configurer la connectivité.

2. Après avoir sélectionné la méthode de connectivité réseau et fourni des informations supplémentaires pour la méthode, cliquez sur CONFIGURER ET CONTINUER.

Configurer des bases de données de migration

Vous pouvez sélectionner les bases de données que vous souhaitez migrer.

1. Dans la liste Bases de données à migrer, sélectionnez l'une des options suivantes :
   • Toutes les bases de données : sélectionne toutes les bases de données qui existent sur la source.
   • Bases de données spécifiques : vous permet de sélectionner des bases de données spécifiques parmi toutes celles qui existent sur la source.

2. Si vous souhaitez migrer des bases de données spécifiques, vous pouvez filtrer la liste qui s'affiche et sélectionner les bases de données que vous souhaitez que Database Migration Service migre vers une destination.

   Si la liste ne s'affiche pas et qu'une erreur de découverte de base de données s'affiche, cliquez sur Recharger. En cas d'échec de la découverte de la base de données, le job migre toutes les bases de données. Vous pouvez continuer à créer un job de migration et corriger les erreurs de connectivité ultérieurement.

3. Cliquez sur Enregistrer et continuer.

Tester et créer le job de migration

Lors de cette dernière étape, examinez le résumé des paramètres du job de migration, de la source, de la destination et de la méthode de connectivité, puis testez la validité de la configuration du job de migration. Si vous rencontrez des problèmes, vous pouvez modifier les paramètres du job de migration. Tous les paramètres ne sont pas modifiables.

1. Cliquez sur TESTER LE JOB pour vérifier que :

   • La base de données source a été configurée correctement, en fonction des conditions préalables.
   • Les instances source et de destination peuvent communiquer entre elles.
   • Toutes les mises à jour des adresses IP privées ou publiques nécessaires sur la destination sont effectuées.

   • Le job de migration est valide et les versions source et de destination sont compatibles.

   Si le test échoue, vous pouvez résoudre le problème dans la partie appropriée du flux, puis revenir pour effectuer un nouveau test.

   Pour en savoir plus sur les raisons pour lesquelles le test peut échouer et sur la résolution des problèmes associés à l'échec du test, consultez la section Diagnostiquer les problèmes liés à PostgreSQL.

   Le job de migration peut être créé même si le test échoue, mais une fois le job démarré, il peut échouer à un moment donné lors de l'exécution.

2. Cliquez sur CRÉER ET DÉMARRER LE JOB pour créer le job de migration et le démarrer immédiatement, ou cliquez sur CRÉER LE JOB pour créer le job de migration sans le démarrer immédiatement.

   Si le job n'est pas démarré au moment de sa création, vous pouvez le démarrer depuis la page Jobs de migration en cliquant sur DÉMARRER.

   Quel que soit le moment où le job de migration démarre, votre organisation est facturée pour l'existence de l'instance de destination.

   Point clé : Lorsque vous démarrez le job de migration, Database Migration Service lance le vidage complet, ce qui verrouille brièvement la base de données source. Si votre source se trouve dans Amazon RDS ou Amazon Aurora, Database Migration Service nécessite en outre un bref temps d'arrêt d'écriture (environ moins d'une minute) au début de la migration.

   Pour en savoir plus, consultez la section Limites connues.

3. Le job de migration est ajouté à la liste des jobs de migration et peut être consulté directement.