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 le job de migration pour vous assurer que les informations de connexion fournies pour le job sont valides.

Remarque : Pour la connectivité IP privée, lorsque vous migrez 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 VPC). Si vous souhaitez utiliser Private Service Connect avec votre cluster de destination, commencez par créer l'instance de destination directement dans Cloud SQL, puis suivez les étapes de la page Migrer vers une instance existante.

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 du job de migration s'ouvre. Cet assistant contient plusieurs panneaux qui vous guident à travers chaque étape de la configuration.

   Vous pouvez suspendre la création d'un job 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 brouillon de tâche de migration plus tard.

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

      Nom lisible de 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 pour votre job 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 le job de migration.

      Database Migration Service est un produit entièrement régional. Cela signifie que toutes les entités liées à votre migration (profils de connexion source et de destination, jobs 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, les applications App Engine ou d'autres services). Une fois que vous avez choisi la région de destination, vous ne pouvez plus la modifier.

      Important : Si vous prévoyez d'utiliser l'édition Enterprise Plus de Cloud SQL pour MySQL, 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ée sur un fichier 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ée 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 du vidage des données ou les indicateurs de vidage.

     Développer cette section pour obtenir la procédure complète de sauvegarde logique

     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 initial de la base de données une fois le job de migration créé et démarré.

        Database Migration Service utilise ce fichier pour reproduire les définitions d'objet 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 des données :

        • Parallélisme du vidage des données : utilisez une option de parallélisme hautes performances, disponible lors de la migration vers MySQL versions 5.7 ou 8.
          Si vous choisissez d'utiliser le parallélisme de chargement, assurez-vous de fournir les privilèges 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 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 :

          • Optimale (recommandée) : 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 le débit de vidage peut être plus lent.
        • Options de vidage : cette option est exclusive avec 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 drapeau :

          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. Cela permet d'accélérer les insertions lorsque le fichier de dump est chargé dans l'instance de destination.
             • ignore-error: Utilisez cette option 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, et 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 du tampon pour cette option.
             Pour en savoir plus sur ces indicateurs, 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 ces étapes pour chaque indicateur que vous souhaitez ajouter.

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

     2. Fournir vos propres libellés

        Cette option est déconseillé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 PARCOURIR, 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 fichier de vidage a été généré au cours des dernières 24 heures et qu'il respecte les exigences relatives aux fichiers de vidage.

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 concernés :
   1. Dans le champ ID de l'instance de destination, indiquez un identifiant pour l'instance Cloud SQL ou utilisez l'identifiant généré automatiquement.

      N'incluez pas d'informations sensibles ni 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, sélectionnez 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 compatibilité de la migration entre les versions

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

      Les éditions Cloud SQL pour MySQL sont fournies avec différents ensembles de fonctionnalités, types de machines disponibles et tarifs. Assurez-vous de consulter la documentation Cloud SQL pour choisir l'édition qui correspond à 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 Toutes pour la zone principale et sur Toutes (différentes 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 migrer à l'aide de l'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 toutes les exigences 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 envisagez de vous connecter à la source de migration à l'aide de l'appairage de VPC, choisissez le VPC où 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 Configurer une adresse IP publique dans la documentation Cloud SQL.

      Vous configurerez la connectivité du job de migration lors d'une prochaine étape. Pour en savoir plus sur les méthodes de mise en réseau disponibles, consultez 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 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. Il 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 instance Cloud SQL. Pour en savoir plus sur le cache de données, consultez 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 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 diminuer.

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 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. 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 que Database Migration Service dispose des autorisations nécessaires pour l'utiliser.

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

      Pour savoir comment créer une CMEK, consultez Utiliser des clés de chiffrement gérées par le client (CMEK).

   2. Ajoutez les indicateurs 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 identiques à ceux de la base de données source. En savoir plus sur les options de base de données compatibles avec MySQL
   3. Ajoutez les étiquettes spécifiques à l'instance Cloud SQL.

      Les libellés vous aident à organiser vos instances. Par exemple, vous pouvez organiser les libellés 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 est en train de créer votre instance Cloud SQL de destination. Ce processus peut prendre plusieurs minutes.
   Point essentiel :

   • Database Migration Service 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 l'utilisateur clique sur Enregistrer et quitter ou s'il quitte l'écran, l'instance Cloud SQL n'est pas nettoyée et devra être supprimée manuellement depuis 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 de VPC.

Si vous souhaitez utiliser…	Alors…
la méthode de connectivité réseau de la 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 l'instance principale et l'instance secondaire.
La 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 fournira un script qui réalise 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 depuis une machine connectée à la base de données source et à Google Cloud.
la méthode de connectivité réseau par appairage de VPC ;	Vous devez sélectionner 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.

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

Tester, créer et exécuter le job de migration

Lors de cette dernière étape, vérifiez le récapitulatif des paramètres de la tâche de migration, de la source, de la destination et de la méthode de connectivité, puis testez la validité de la configuration de la tâche 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. 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 savoir comment résoudre les problèmes liés à un test de tâche de migration qui échoue, consultez Diagnostiquer les problèmes liés à MySQL.

2. Une fois le test du job de migration terminé, 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, il peut l'être 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.

   Votre migration est en cours. 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 é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 Limites connues.

   Attention : Si vous avez utilisé Terraform pour provisionner votre base de données de destination, vous risquez de rencontrer 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 Dérive de configuration Terraform.
3. Passez à la section Examiner le job de migration.

gcloud

1. Créez le profil de connexion de destination.
   Lorsque vous migrez vers une nouvelle instance de destination avec 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 la développer) :

   gcloud database-migration connection-profiles create cloudsql

   Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter les commandes de manière asynchrone. Si c'est le 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 par la version de MySQL que vous souhaitez utiliser dans l'instance de destination. Les versions de la 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 connaître toutes les versions de MySQL possibles, consultez la référence de 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 ou 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 Types de machines dans la documentation Cloud SQL pour MySQL.

     Les instances créées avec la Google Cloud CLI utilisent par défaut 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 Enterprise de Cloud SQL pour MySQL, 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 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'option facultative --edition.

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

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

     Vous n'avez pas besoin d'utiliser d'autres indicateurs si vous souhaitez utiliser la connectivité par adresse IP publique. Si vous souhaitez utiliser la connectivité par adresse IP privée avec le peering de réseaux VPC ou un tunnel SSH inversé, assurez-vous de répondre aux exigences réseau supplémentaires suivantes pour activer la connectivité par adresse IP privée et incluez des indicateurs supplémentaires dans votre commande.

     Développez cette section pour connaître toutes les exigences 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 à la fois une adresse IP publique et une adresse IP privée à votre instance de destination, mais vous n'aurez peut-être pas besoin d'adresse IP publique si vous utilisez la 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é la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes 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é la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes 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é la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes 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 le job de migration.
   Si vous utilisez l'appairage de VPC ou une connectivité de tunnel SSH inversé, assurez-vous d'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 Google Cloud CLI.
    Exécutez la commande suivante (cliquez sur le lien pour la développer) :

   gcloud database-migration migration-jobs create

   Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter les commandes de manière asynchrone. Si c'est le 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 par un identifiant lisible par machine pour votre job de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes Google Cloud CLI ou de l'API Database Migration Service.
   • REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le job de migration.
   • MIGRATION_JOB_NAME par un nom lisible pour votre job de migration. Cette valeur s'affiche dans la console Google Cloud de Database Migration Service.
   • 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é la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes 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é la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes 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é la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes 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]