For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/databases/mysql-external-database-migration.md.
Aller au contenu

Migrer vers OVHcloud Public Cloud Databases pour MySQL

Voir en Markdown

Découvrez comment migrer une base de données MySQL externe vers une base de données MySQL managée OVHcloud, avec une interruption minimale

Objectif

Ce guide explique comment migrer une base de données MySQL externe — hébergée sur vos propres serveurs, sur une machine virtuelle ou chez un autre fournisseur — vers un service Public Cloud Databases pour MySQL OVHcloud.

La migration copie d'abord vos données, puis continue de répliquer les modifications faites sur la source jusqu'à ce que vous l'arrêtiez. Vous pouvez ainsi basculer votre application vers le nouveau service au moment de votre choix, avec une interruption minimale.

La migration se pilote depuis l'API OVHcloud. La console OVHcloud ne la propose pas.

Prérequis

  • Disposer d'un projet Public Cloud dans votre compte OVHcloud.
  • Disposer d'un service Public Cloud Databases pour MySQL en réseau public (le guide « Premiers pas avec les bases de données Public Cloud » peut vous aider à répondre à ce prérequis). Pour un service en réseau privé, la source doit être joignable depuis ce réseau privé ; ce cas n'est pas couvert par ce guide.
  • Disposer d'un accès à l'.
  • Disposer d'un accès administrateur au serveur source : vous devrez modifier sa configuration et ses règles de pare-feu, et y créer un utilisateur.

En pratique

Étape 1 - Vérifier que votre base source est compatible

La base de données source doit être en MySQL 5.7 ou 8.0. Une source en 8.0 peut être migrée vers un service d'une version plus récente : la montée de version se fait pendant la migration.

La migration s'appuie sur la réplication MySQL. Le serveur source doit utiliser les réglages suivants :

ParamètreValeur requiseRôle
gtid_modeONLa réplication s'appuie sur les identifiants globaux de transaction
enforce_gtid_consistencyONNécessaire pour activer gtid_mode
log_binactivéSans journal binaire, les modifications ne peuvent pas être répliquées
binlog_formatROWFormat de réplication utilisé par la migration
binlog_row_imageFULLImages complètes des lignes dans le journal binaire
server_idtoute valeur différente de 0Identifie le serveur dans la réplication

TLS doit également être activé sur le serveur source, car la migration s'y connecte de manière chiffrée.

Exécutez la requête suivante sur la source pour vérifier les valeurs actuelles :

SELECT @@gtid_mode, @@enforce_gtid_consistency, @@log_bin, @@binlog_format, @@binlog_row_image, @@server_id;

Si une valeur diffère, définissez-la dans le fichier de configuration du serveur (my.cnf, section [mysqld]), par exemple :

[mysqld]
server_id = 1
log_bin = mysql-bin
binlog_format = ROW
binlog_row_image = FULL
gtid_mode = ON
enforce_gtid_consistency = ON
Warning

La modification de ces réglages nécessite généralement un redémarrage du serveur MySQL. Prévoyez une fenêtre de maintenance. Pour activer les GTID sans arrêter un serveur déjà en production, suivez la procédure MySQL d'activation des GTID en ligne.

Étape 2 - Autoriser votre service OVHcloud à joindre la source

La migration fonctionne dans le sens inverse de celui de vos applications : c'est votre service OVHcloud qui se connecte à votre base source, sur son port MySQL. La source doit donc accepter les connexions provenant de l'adresse de votre service.

Pour trouver cette adresse, ouvrez votre service dans la . Dans la carte Détails de connexion de l'onglet Vue d'ensemble, copiez l'hôte, puis résolvez-le :

dig +short <hote-du-service>

Côté source, autorisez les connexions TCP entrantes sur le port MySQL (3306 par défaut) depuis cette seule adresse. Vous supprimerez cette règle une fois la migration terminée.

Warning

La migration s'arrête, et ne repart pas d'elle-même, dans les cas suivants :

  • Le nœud de votre service est remplacé, par exemple lors d'une maintenance. L'appel de suivi de l'étape 5 renvoie alors le statut failed avec l'erreur Primary node got replaced during migration. L'adresse de votre service change aussi : résolvez de nouveau l'hôte, puis mettez à jour la règle de pare-feu et l'hôte autorisé de l'utilisateur migration.
  • La source est injoignable ou refuse la connexion pendant une dizaine de minutes, par exemple après un changement du mot de passe de l'utilisateur migration. L'appel de suivi de l'étape 5 renvoie le statut failed avec l'erreur de connexion.

Une fois la cause corrigée, relancez la migration : arrêtez-la avec l'appel de l'étape 7, refaites la vérification de l'étape 4, puis lancez de nouveau la migration comme à l'étape 5. Renvoyer l'appel de lancement de l'étape 5 sans arrêter d'abord la migration ne la relance pas.

La migration repart alors d'une copie complète de la source : dans les bases migrées, les données écrites directement sur votre service OVHcloud sont écrasées. Si la relance échoue, contactez le support OVHcloud.

Info

La vérification de l'étape 4 teste cette connexion : si la source est injoignable, la vérification échoue et en indique la raison.

Étape 3 - Créer un utilisateur de migration dédié sur la source

Warning

Le mot de passe de cet utilisateur est transmis en clair dans le corps des appels API des étapes 4 et 5. Il peut donc apparaître dans vos scripts, l'historique de votre terminal ou les journaux de vos outils. Créez un utilisateur dédié à la migration, avec un mot de passe robuste que vous n'utilisez nulle part ailleurs.

Cet utilisateur ne sert que le temps de la migration : vous le supprimez à l'étape 8, une fois la bascule faite. Son mot de passe devient alors inutilisable, même s'il a été conservé quelque part.

Créez l'utilisateur sur la source, limité à l'adresse de votre service OVHcloud trouvée à l'étape 2, et attribuez-lui les privilèges nécessaires à la migration :

CREATE USER 'migration'@'<adresse-du-service>' IDENTIFIED BY '<mot-de-passe-robuste>';

GRANT SELECT, RELOAD, SHOW DATABASES, REPLICATION SLAVE, REPLICATION CLIENT,
      SHOW VIEW, TRIGGER, EVENT, LOCK TABLES, PROCESS
      ON *.* TO 'migration'@'<adresse-du-service>';

Étape 4 - Vérifier que la migration est possible

Les appels API de ce guide nécessitent l'identifiant de votre projet Public Cloud (serviceName) et celui de votre service MySQL (clusterId). Pour les trouver, exécutez les appels API suivants et copiez l'identifiant de votre projet, puis celui de votre service, dans les listes qu'ils renvoient :

GET/cloud/project

Créez une tâche qui vérifie si la migration est possible :

{
  "sourceHost": "<hote-source>",
  "sourcePort": 3306,
  "sourceUsername": "migration",
  "sourcePassword": "<mot-de-passe-robuste>",
  "sourceSsl": true
}

La tâche démarre avec le statut running. Récupérez son résultat avec l'appel API suivant :

Une fois la vérification terminée, le champ status vaut done. Si le champ success vaut true, vous pouvez continuer. Le champ result indique aussi la méthode de migration qui sera utilisée :

{
  "status": "done",
  "result": "All pre-checks passed successfully, preferred migration method will be [Replication]",
  "success": true
}

Si success vaut false, le champ result explique ce qui manque — par exemple un réglage de la source de l'étape 1 ou l'accès réseau de l'étape 2. Corrigez-le, puis relancez la vérification.

Étape 5 - Lancer la migration

Warning

N'écrivez pas dans votre service OVHcloud pendant la migration. Le service reste accessible en écriture pendant toute la migration, et les données qui y seraient écrites directement divergeraient de la source sans qu'aucune erreur ne soit signalée.

Créez la tâche de migration, avec le même corps que pour la vérification :

L'API confirme le démarrage de la migration :

{
  "status": "running",
  "error": "",
  "method": "replication",
  "message": "The migration process is running"
}

Suivez sa progression avec l'appel API suivant :

Une fois les données copiées, la migration continue de répliquer les modifications faites sur la source. Le champ status passe alors à done, bien que la réplication continue, et le champ message indique Take care, the replication still synchronise your source database, feel free to stop the replication whenever you want. Si la migration s'interrompt, le champ status passe à failed et le champ error en donne la raison.

Vous pouvez aussi vérifier la réplication depuis votre service OVHcloud, en vous connectant avec l'utilisateur avnadmin (le guide « Se connecter avec la CLI au service Public Cloud Databases pour MySQL » explique comment se connecter). Tant que la réplication est active, la requête suivante renvoie ON :

SELECT SERVICE_STATE FROM performance_schema.replication_connection_status;

Étape 6 - Vérifier les données migrées

Avant de basculer votre application, comparez la source et le service :

  • le nombre de lignes de vos principales tables ;

  • leurs sommes de contrôle, qui doivent être identiques des deux côtés :

    CHECKSUM TABLE <base>.<table>;
  • une écriture de test : insérez ou modifiez une ligne sur la source, puis vérifiez qu'elle apparaît sur votre service OVHcloud quelques instants plus tard.

Les tables, les vues et les colonnes générées sont migrées. Les utilisateurs et leurs privilèges ne le sont pas : vous les recréez à l'étape 7.

Étape 7 - Basculer votre application

  1. Arrêtez les écritures de votre application sur la base source.

  2. Vérifiez que les dernières modifications sont arrivées sur votre service OVHcloud, en comparant à nouveau les sommes de contrôle de l'étape 6.

  3. Arrêtez la migration :

  4. Vérifiez le statut de la migration avec l'appel API de l'étape 5 :

    Selon les cas, l'appel renvoie le statut done ou une erreur Bad Request.

    Warning

    Le statut done ne prouve pas que la migration est arrêtée : il s'affiche déjà pendant la réplication. Pour vous en assurer, vérifiez que la requête de l'étape 5 sur performance_schema.replication_connection_status ne renvoie plus ON et qu'une écriture faite sur la source n'arrive plus sur votre service.

  5. Recréez les utilisateurs de votre application sur votre service OVHcloud, depuis l'onglet Utilisateurs de la console OVHcloud ou en SQL, et attribuez-leur les privilèges dont ils ont besoin.

  6. Faites pointer votre application vers l'hôte et le port de votre service OVHcloud, et autorisez les adresses IP de votre application sur le service (le guide « Configurez les connexions entrantes d'un service Public Cloud Databases pour MySQL » explique comment procéder).

Warning

Si vous n'arrêtez pas la migration, elle continue de répliquer la source : des données supprimées sur la source seraient aussi supprimées sur votre service OVHcloud.

Étape 8 - Nettoyer la source

Une fois que votre application fonctionne sur votre service OVHcloud :

  • supprimez l'utilisateur de migration sur la source : DROP USER 'migration'@'<adresse-du-service>';
  • supprimez la règle de pare-feu qui autorise votre service OVHcloud à joindre la source.

Aller plus loin

Capacités et limitations de Public Cloud Databases pour MySQL

Configurez les connexions entrantes d'un service Public Cloud Databases pour MySQL

Rejoignez notre chaîne Discord dédiée : https://discord.gg/ovhcloud. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l'équipe qui développe nos services de bases de données.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?