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

MySQL   |  PostgreSQL   |  PostgreSQL vers AlloyDB

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

• Définir les paramètres du job de migration.
• Spécifiez 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 la tâche de migration pour vous assurer que les informations de connexion fournies pour la tâche sont valides.

Pour créer un job de migration vers une nouvelle instance de destination, procédez comme suit:

Console

Définir les paramètres du job de migration

1. Dans la console Google Cloud, accédez à la page Jobs de migration.

   Accéder à la page "Jobs de migration"

2. Cliquez sur Créer un job de migration.

   La page de l'assistant de configuration de la tâche de migration s'ouvre. Cet assistant contient plusieurs panneaux qui vous guident à chaque étape de la configuration.

   Vous pouvez suspendre la création d'une tâche de migration à tout moment en cliquant sur Enregistrer et quitter. Toutes les données que vous saisissez jusqu'à ce point sont enregistrées dans un brouillon de tâche de migration. Vous pourrez terminer votre tâche de migration d'essai plus tard.

3. Sur la page Premiers pas, saisissez les informations suivantes :
   1. Nom de la tâche de migration

      Il s'agit d'un nom lisible pour votre tâche de migration. Cette valeur s'affiche dans la console Google Cloud.

   2. ID du job de migration

      Il s'agit d'un identifiant lisible par machine de votre tâche de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes ou de l'API Google Cloud CLI de Database Migration Service.

   3. Dans la liste Moteur de base de données source, sélectionnez MySQL.

      Le champ Moteur de base de données de destination est renseigné automatiquement et ne peut pas être modifié.

   4. Sélectionnez la région dans laquelle vous enregistrez la tâche de migration.

      Database Migration Service est un produit entièrement régional, ce qui signifie que toutes les entités liées à votre migration (profils de connexion source et de destination, tâches de migration, bases de données de destination) doivent être enregistrées dans une seule région. Sélectionnez la région en fonction de l'emplacement des services qui ont besoin de vos données (comme les instances Compute Engine ou 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 MySQL 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 MySQL.
4. Cliquez sur Enregistrer et continuer.

Spécifier des informations sur le profil de connexion source

Sur la page Définir une source, procédez comme suit:

1. Dans le menu déroulant Profil de connexion source, sélectionnez le profil de connexion de votre base de données source.
2. Dans la section Personnaliser la configuration du vidage complet, cliquez sur Modifier la configuration.
3. Dans le panneau Modifier la configuration de vidage complet, sélectionnez l'une des options suivantes dans le menu déroulant Méthode de vidage complet :
   • Basé sur le physique: sélectionnez cette option si vous souhaitez utiliser l'utilitaire Percona XtraBackup pour fournir votre propre fichier de sauvegarde. Cette approche nécessite des étapes de préparation supplémentaires. Pour obtenir le guide complet sur l'utilisation des fichiers de sauvegarde physiques générés par Percona XtraBackup, consultez Migrer vos bases de données à l'aide d'un fichier physique Percona XtraBackup.
   • Basé sur la logique: sélectionnez cette option si vous souhaitez utiliser un fichier de sauvegarde logique créé par l'utilitaire mysqlshell. Database Migration Service peut générer automatiquement ce fichier de sauvegarde pour vous ou vous pouvez fournir votre propre copie.
4. Modifiez les autres paramètres de vidage. Effectuez l'une des opérations suivantes :
   • Si vous utilisez le fichier de sauvegarde physique, dans Indiquez votre dossier, cliquez sur Parcourir, puis sélectionnez le dossier dans lequel vous avez importé votre fichier de dump complet. Veillez à sélectionner le dossier dédié contenant le fichier de sauvegarde complet, et non le bucket de stockage lui-même.

   • Si vous utilisez un fichier de sauvegarde logique, configurez le parallélisme de vidage des données ou les indicateurs de vidage.

     Développez cette section pour obtenir la procédure complète de sauvegarde logique des fichiers.

     Dans la section Choisir le mode de génération du fichier de dump, utilisez l'une des options suivantes:

     1. Générer automatiquement le fichier de dump initial (recommandé)

        Cette option est recommandée, car Database Migration Service génère toujours un fichier de dump de base de données initial après la création et le démarrage du job de migration.

        Database Migration Service utilise ce fichier pour reproduire les définitions d'objets et les données de table d'origine de votre base de données source afin que ces informations puissent être migrées vers une instance de base de données Cloud SQL de destination.

        Si vous utilisez le vidage généré automatiquement, sélectionnez le type d'opération que Database Migration Service doit effectuer dans la section Configurer l'opération de vidage de données:

        • Parallélisme de vidage de données: utilisez une option de parallélisme hautes performances, disponible lors de la migration vers les versions 5.7 ou 8 de MySQL.
          Si vous choisissez d'utiliser le parallélisme de charge, assurez-vous de fournir les droits nécessaires sur la base de données source pour votre scénario (par exemple, LOCK_TABLES). Pour en savoir plus sur les autorisations requises pour les bases de données sources, consultez la section Configurer la base de données source.

          La vitesse du parallélisme des données est liée à la charge induite sur votre base de données source:

          • Optimal (recommandé): performances équilibrées avec une charge optimale sur la base de données source.
          • Maximum: fournit 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 le débit de vidage peut être plus lent.
        • Options de vidage: cette option est exclusive avec l'option Parallélisme du vidage des données. Utilisez ce paramètre pour configurer directement les indicateurs de l'utilitaire mysqldump utilisé pour créer le fichier de dump.

          Pour ajouter un indicateur:

          1. Cliquez sur AJOUTER UNE OPTION.

          2. Sélectionnez l'un des indicateurs suivants:

             • add-locks: Ce flag entoure chaque table contenue dans le fichier de dump avec des instructions LOCK TABLES et UNLOCK TABLES. Les insertions sont ainsi plus rapides lorsque le fichier de dump est chargé dans l'instance de destination.
             • ignore-error: Utilisez cet indicateur pour saisir une liste de numéros d'erreur séparés par une virgule. Ces nombres représentent les erreurs que l'utilitaire mysqldump ignorera.
             • max-allowed-packet: Utilisez cet indicateur pour définir la taille maximale du tampon pour la communication entre le client MySQL et la base de données MySQL source. La taille par défaut de la mémoire tampon est de 24 Mo. La taille maximale est de 1 Go.
               Si vous utilisez de grandes colonnes BLOB ou de longues chaînes dans les tables de la base de données source, vous devez augmenter la taille de la mémoire tampon pour cet indicateur.
             Pour en savoir plus sur ces options, consultez la documentation sur l'utilitaire mysqldump dans le Manuel de référence MySQL 8.0.
          3. Cliquez sur OK.
          4. Répétez cette procédure pour chaque indicateur que vous souhaitez ajouter.

          Pour supprimer un indicateur, cliquez sur l'icône de corbeille à droite de la ligne correspondante.

     2. Fournir les vôtres

        Cette option n'est pas recommandée, car par défaut, Database Migration Service effectue un vidage initial lors de l'exécution du job de migration.

        Si vous souhaitez utiliser votre propre fichier de dump, sélectionnez Fournir le vôtre, cliquez sur PARCOURRIR, sélectionnez votre fichier (ou l'intégralité du dossier Cloud Storage si vous utilisez plusieurs fichiers), puis cliquez sur SÉLECTIONNER.

        Assurez-vous que le dump a été généré au cours des dernières 24 heures et qu'il respecte les exigences concernant les vidages.

5. Cliquez sur Enregistrer et continuer.

Configurer et créer l'instance Cloud SQL de destination

1. Sur la page Définir une destination, dans le menu déroulant Type d'instance de destination, sélectionnez Nouvelle instance. Définissez tous les paramètres pertinents :
   1. Dans le champ ID de l'instance de destination, fournissez un identifiant pour l'instance Cloud SQL ou utilisez l'identifiant généré automatiquement.

      N'incluez pas d'informations sensibles ni d'informations permettant d'identifier personnellement l'utilisateur dans l'identifiant. Vous n'avez pas besoin d'indiquer l'ID du projet dans le nom de l'instance. Cet ajout s'effectue automatiquement le cas échéant (par exemple, dans les fichiers journaux).

   2. Dans le champ Mot de passe, indiquez un mot de passe alphanumérique pour l'instance Cloud SQL de destination. Il s'agit du mot de passe du compte administrateur root 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.

   3. Dans le menu déroulant Version de la base de données, choisissez la version de la base de données pour l'instance de destination.

      Cliquez sur Afficher les versions mineures pour afficher toutes les versions mineures. En savoir plus sur la prise en charge de la migration entre versions

   4. Sélectionnez l'édition Cloud SQL pour MySQL de votre instance de destination. Deux options sont disponibles: l'édition Cloud SQL pour MySQL Enterprise et l'édition Cloud SQL pour MySQL Enterprise Plus.

      Les éditions Cloud SQL pour MySQL sont fournies avec différents ensembles de fonctionnalités, de types de machines disponibles et de 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 MySQL.

   5. Le menu Région affiche la même région que celle que vous avez sélectionnée sur la page Premiers pas.

      Si vous configurez votre instance pour la haute disponibilité, sélectionnez Plusieurs zones (haute disponibilité). Vous pouvez sélectionner la zone principale et la zone 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 Tout pour la zone principale et sur Tout (différent de la zone principale) pour la zone secondaire.
      • Si les zones principale et secondaire sont spécifiées, elles doivent être distinctes l'une de l'autre.
   6. Dans la section Connexions, choisissez d'ajouter une adresse IP publique ou privée pour votre instance de destination. Vous pouvez configurer votre instance pour qu'elle dispose des deux types d'adresses IP, mais au moins un type est requis pour la migration. Sélectionnez l'une des options suivantes :
      • Si vous souhaitez effectuer la migration à l'aide d'un appairage de VPC ou d'un tunnel SSH inversé, sélectionnez Adresse IP privée.

        • Pour activer la connectivité IP privée, assurez-vous de répondre à toutes les exigences réseau supplémentaires.

          Développez cette section pour connaître les exigences complètes concernant les adresses IP privées.

          • L'API Service Networking est activée. Vous pouvez activer l' API Service Networking à l'aide de la console Google Cloud.
          • 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.
          • Votre projet contient au moins un réseau VPC non hérité 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.
            • Ajouter votre utilisateur au projet hôte.
            • Attribuez à votre utilisateur le rôle IAM compute.networkAdmin dans le projet hôte.
        • Sélectionnez le réseau VPC associé à appairer. Si vous prévoyez de vous connecter à la source de migration à l'aide de l'appairage de VPC, choisissez le VPC dans lequel se trouve l'instance.
        • Si aucun réseau de service géré n'a jamais été configuré pour le VPC sélectionné, vous pouvez sélectionner une plage d'adresses IP et cliquer sur Connecter, ou utiliser une plage d'adresses IP sélectionnée automatiquement et cliquer sur Allouer et connecter.
      • Si vous souhaitez migrer sur Internet à l'aide d'une liste d'autorisation d'adresses IP, sélectionnez Adresse IP publique.
        

        Si vous le souhaitez, sous Adresse IP publique, cliquez sur le champ Réseaux autorisés, puis autorisez un réseau ou un proxy à se connecter à l'instance Cloud SQL. Les réseaux ne sont autorisés qu'avec les adresses que vous fournissez. Consultez la section Configurer une adresse IP publique dans la documentation Cloud SQL.

      Vous configurerez la connectivité de la tâche de migration à une étape ultérieure. Pour en savoir plus sur les méthodes de mise en réseau disponibles, consultez la section Configurer la connectivité.

2. 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. En savoir plus sur les types de machines MySQL
   Remarque:Les machines disponibles dans la sélection Type de machine dépendent de l'édition Cloud SQL que vous utilisez.
3. Pour l'édition Cloud SQL pour MySQL 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 MySQL Enterprise Plus. Elle ajoute un disque SSD local à grande 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.

4. Indiquez le type de stockage pour l'instance Cloud SQL. Vous pouvez choisir un disque dur SSD ou un disque dur HDD.
5. Spécifiez la capacité de stockage (en Go) de l'instance Cloud SQL.

   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 pas la réduire.

6. (Facultatif) Configurez les options de chiffrement des données ou les libellés de ressources pour votre instance de destination.

   Développez cette section pour afficher les étapes facultatives.

   Cliquez sur Afficher les configurations facultatives, puis:

   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 à l'aide d'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 clé CMEK.

      Si vous ne trouvez pas votre clé, cliquez sur Saisissez le nom de la ressource de clé pour indiquer le nom de la ressource de la clé que vous souhaitez utiliser. Exemple de nom de ressource de clé : projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

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

      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 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 à appliquer au serveur de base de données. Si possible, assurez-vous que les indicateurs de base de données de l'instance Cloud SQL de destination créée sont les mêmes que ceux de la base de données source. En savoir plus sur les options de base de données compatibles avec MySQL
   3. Ajoutez toutes 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.

7. Cliquez sur Créer une destination et continuer. Database Migration Service crée maintenant votre instance de destination Cloud SQL. Ce processus peut prendre plusieurs minutes.
   Principe clé:

   • Database Migration Service crée une instance Cloud SQL pour laquelle vous serez facturé en fonction de la configuration spécifiée. Si le flux de création de la tâche de migration est arrêté avant la fin, utilisez le bouton Cancel (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 doit être supprimée manuellement de la page "Instances Cloud SQL".
   • Une fois l'instance de destination créée, les paramètres de l'instance Cloud SQL ne peuvent plus être modifiés dans la console Database Migration Service. Vous pouvez toujours accéder à l'instance directement dans la console Cloud SQL pour la modifier.

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

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 la liste d'autorisation d'adresses IP, le tunnel SSH inversé et l'appairage VPC.

Si vous souhaitez utiliser…	Alors…
la méthode de connectivité réseau par 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 de l'instance principale et de l'instance secondaire.
Méthode de connectivité réseau du tunnel SSH inversé	Vous devez sélectionner 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 la Google Cloud CLI. Exécutez les commandes à partir d'une machine connectée à la fois à la base de données source et à Google Cloud.
la méthode de connectivité réseau d'appairage VPC ;	Vous devez sélectionner le réseau VPC sur lequel est hébergée la base de données source. L'instance Cloud SQL est mise à jour afin de se connecter à ce réseau.

Après avoir sélectionné et configuré la connectivité réseau, cliquez sur Configurer et continuer.

Tester, créer et exécuter la tâche de migration

Lors de cette dernière étape, examinez le résumé des paramètres, de la source, de la destination et de la méthode de connectivité de la tâche de migration, puis testez la validité de la configuration de la tâche de migration. En cas de problème, vous pouvez modifier les paramètres de la tâche de migration. Tous les paramètres ne sont pas modifiables.

1. Sur la page Tester et créer une tâche de migration, cliquez sur Tester la tâche.

   Si le test échoue, vous pouvez résoudre le problème dans la partie appropriée du flux, puis revenir au test. Pour obtenir des informations sur le dépannage d'un test de tâche de migration qui échoue, consultez la section Diagnostiquer les problèmes liés à MySQL.

2. Lorsque le test du job de migration est terminé, cliquez sur Créer et démarrer le job pour créer le job de migration et le démarrer immédiatement, ou sur Créer le job pour créer le job de migration sans le démarrer immédiatement.

   Si la tâche n'est pas démarrée au moment de sa création, vous pouvez la démarrer sur la page Tâches de migration en cliquant sur DÉMARRER. Quelle que soit la date de début du job de migration, votre organisation est facturée pour l'existence de l'instance de destination.

   Votre migration est en cours. Lorsque vous démarrez la tâche de migration, Database Migration Service lance le vidage complet, en bloquant brièvement la base de données source. Si votre source se trouve dans Amazon RDS ou Amazon Aurora, Database Migration Service nécessite également 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.

   Attention:Si vous avez utilisé Terraform pour provisionner votre base de données de destination, vous risquez de constater une dérive de configuration lors de l'exécution du job de migration. N'essayez pas de réappliquer les paramètres Terraform avant la fin de la migration. Pour en savoir plus, consultez la section Écart de configuration Terraform.
3. Passez à l'étape Examiner la tâche de migration.

gcloud

1. Créez le profil de connexion de destination.
   Lorsque vous migrez vers une nouvelle instance de destination avec la Google Cloud CLI, vous créez l'instance de destination et le profil de connexion en une seule action.
   Exécutez la commande suivante (cliquez sur le lien pour l'agrandir):

   gcloud database-migration connection-profiles create cloudsql

   Cet exemple utilise l'option --no-async facultative afin que toutes les opérations soient effectuées de manière synchrone. Cela signifie que certaines commandes peuvent prendre un certain temps. Vous pouvez ignorer l'indicateur --no-async pour exécuter des commandes de manière asynchrone. Dans ce cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre opération a réussi.

   Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

   • CONNECTION_PROFILE_ID avec un identifiant lisible par machine pour votre profil de connexion.
   • DATABASE_VERSION avec la version MySQL que vous souhaitez utiliser dans l'instance de destination. Les versions de base de données sont spécifiées sous forme de chaînes incluant à la fois la version majeure et la version mineure. Par exemple: MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36.

     Pour toutes les versions MySQL possibles, consultez la documentation de référence sur l'option --database-version.

   • (Facultatif) EDITION Par défaut, les nouvelles instances que vous créez avec la Google Cloud CLI utilisent l'édition Cloud SQL pour MySQL Enterprise Plus. Si vous prévoyez d'utiliser l'édition Cloud SQL pour MySQL 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 MySQL.

     Vous pouvez modifier votre édition à l'aide de l'indicateur --edition avec l'une des valeurs suivantes:

     • enterprise-plus pour l'édition Cloud SQL pour MySQL Enterprise Plus
     • enterprise pour l'édition Cloud SQL pour MySQL Enterprise
   • TIER par le nom du type de machine Cloud SQL que vous souhaitez utiliser. Les types de machines sont spécifiés sous forme de chaînes qui suivent la convention Cloud SQL, par exemple db-n1-standard-1, db-perf-optimized-N-2. Pour obtenir la liste complète des types de machines disponibles et de leurs identifiants à utiliser avec Google Cloud CLI, consultez la section Types de machines dans la documentation Cloud SQL pour MySQL.

     Par défaut, les instances créées avec la Google Cloud CLI utilisent l'édition Cloud SQL pour MySQL Enterprise Plus, qui propose différents types de machines. Si vous souhaitez utiliser un type de machine disponible uniquement dans l'édition Cloud SQL pour MySQL Enterprise, utilisez l'indicateur facultatif --edition=enterprise pour spécifier l'édition.

   • REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le profil de connexion.

     Par défaut, les nouvelles instances que vous créez avec la Google Cloud CLI utilisent l'édition Cloud SQL pour MySQL Enterprise Plus. Si vous prévoyez d'utiliser l'édition Cloud SQL pour MySQL 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 MySQL. Vous pouvez modifier l'édition à l'aide de l'indicateur --edition facultatif.

   • (Facultatif) CONNECTION_PROFILE_NAME avec un nom lisible pour votre profil de connexion. Cette valeur s'affiche dans la console Google Cloud.
   • Configuration réseau

     Par défaut, une adresse IP publique est attribuée aux nouvelles instances que vous créez avec Google Cloud CLI et elles sont configurées pour utiliser la connectivité IP publique. Vous pouvez utiliser d'autres méthodes de connectivité. Pour en savoir plus, consultez la section Configurer la connectivité.

     Vous n'avez pas besoin d'utiliser d'indicateurs supplémentaires si vous souhaitez utiliser la connectivité par adresse IP publique. Si vous souhaitez utiliser la connectivité IP privée avec l'appairage de réseaux VPC ou un tunnel SSH inverse, assurez-vous de respecter les exigences réseau supplémentaires suivantes pour activer la connectivité IP privée et d'inclure des options supplémentaires dans votre commande.

     Développez cette section pour connaître les exigences complètes concernant les adresses IP privées.

     • L'API Service Networking est activée. Vous pouvez activer l' API Service Networking à l'aide de la console Google Cloud.
     • 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.
     • Votre projet contient au moins un réseau VPC non hérité 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.
       • Ajouter votre utilisateur au projet hôte.
       • Attribuez à votre utilisateur le rôle IAM compute.networkAdmin dans le projet hôte.

     Incluez les indicateurs supplémentaires suivants si vous souhaitez utiliser la connectivité IP privée (avec l'appairage de réseaux VPC ou avec un tunnel SSH inversé sur une VM Compute Engine):

     • --no-enable-ip-v4: (facultatif) pour ne pas attribuer d'adresse IP publique à votre instance de destination. Vous pouvez attribuer une adresse IP publique et une adresse IP privée à votre instance de destination, mais vous ne souhaitez peut-être pas d'adresse IP publique si vous utilisez une connectivité IP privée.
     • --private-network: pour attribuer une adresse IP privée à votre instance de destination, spécifiez le nom du cloud privé virtuel auquel vous souhaitez attribuer une adresse IP privée.

   Exécutez la commande suivante :

   Linux, macOS ou Cloud Shell

   Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

   gcloud database-migration connection-profiles \
   create mysql CONNECTION_PROFILE_ID \
     --no-async \
     --region=REGION \
     --database-version=DATABASE_VERSION \
     --tier=TIER \
     --display-name=CONNECTION_PROFILE_NAME

   Windows (PowerShell)

   Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

   gcloud database-migration connection-profiles `
   create mysql CONNECTION_PROFILE_ID `
     --no-async `
     --region=REGION `
     --database-version=DATABASE_VERSION `
     --tier=TIER `
     --display-name=CONNECTION_PROFILE_NAME

   Windows (cmd.exe)

   Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

   gcloud database-migration connection-profiles ^
   create mysql CONNECTION_PROFILE_ID ^
     --no-async ^
     --region=REGION ^
     --database-version=DATABASE_VERSION ^
     --tier=TIER ^
     --display-name=CONNECTION_PROFILE_NAME

   Vous devriez obtenir un résultat semblable à celui-ci :

   Waiting for connection profile [CONNECTION_PROFILE_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
   

2. Créez la tâche de migration.
   Si vous utilisez l'appairage VPC ou une connectivité de tunnel SSH inversé, veillez à ajouter les indicateurs requis, tels que --peer-vpc, ou --vm, --vm-ip, --vm-port, --vpc. Pour en savoir plus, consultez Configurer la connectivité et Exemples de Google Cloud CLI.
   Exécutez la commande suivante (cliquez sur le lien pour l'agrandir):

   gcloud database-migration migration-jobs create

   Cet exemple utilise l'option --no-async facultative afin que toutes les opérations soient effectuées de manière synchrone. Cela signifie que certaines commandes peuvent prendre un certain temps. Vous pouvez ignorer l'indicateur --no-async pour exécuter des commandes de manière asynchrone. Dans ce cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre opération a réussi.

   Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

   • MIGRATION_JOB_ID avec un identifiant lisible par machine pour votre tâche de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes ou de l'API Google Cloud CLI de Database Migration Service.
   • REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer la tâche de migration.
   • MIGRATION_JOB_NAME par un nom lisible pour votre tâche de migration. Cette valeur s'affiche dans Database Migration Service dans la console Google Cloud.
   • SOURCE_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion source.
   • DESTINATION_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion de destination.

   Exécutez la commande suivante :

   Linux, macOS ou Cloud Shell

   Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs \
   create MIGRATION_JOB_ID \
     --no-async \
     --region=REGION \
     --display-name=MIGRATION_JOB_NAME \
     --source=SOURCE_CONNECTION_PROFILE_ID \
     --destination=DESTINATION_CONNECTION_PROFILE_ID \
     --type=MIGRATION_JOB_TYPE

   Windows (PowerShell)

   Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs `
   create MIGRATION_JOB_ID `
     --no-async `
     --region=REGION `
     --display-name=MIGRATION_JOB_NAME `
     --source=SOURCE_CONNECTION_PROFILE_ID `
     --destination=DESTINATION_CONNECTION_PROFILE_ID `
     --type=MIGRATION_JOB_TYPE

   Windows (cmd.exe)

   Remarque : Assurez-vous d'avoir initialisé Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init ou gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs ^
   create MIGRATION_JOB_ID ^
     --no-async ^
     --region=REGION ^
     --display-name=MIGRATION_JOB_NAME ^
     --source=SOURCE_CONNECTION_PROFILE_ID ^
     --destination=DESTINATION_CONNECTION_PROFILE_ID ^
     --type=MIGRATION_JOB_TYPE

   Vous devriez obtenir un résultat semblable à celui-ci :

   Waiting for migration job [MIGRATION_JOB_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created migration job MIGRATION_JOB_ID [OPERATION_ID]