Migrer vers OVHcloud Public Cloud Databases pour MySQL
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 :
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 :
Si une valeur diffère, définissez-la dans le fichier de configuration du serveur (my.cnf, section [mysqld]), par exemple :
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 :
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.
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
failedavec l'erreurPrimary 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'utilisateurmigration. - 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 statutfailedavec 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.
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
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 :
É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 :
Créez une tâche qui vérifie si la migration est possible :
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 :
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
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 :
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 :
É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 :
-
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
-
Arrêtez les écritures de votre application sur la base source.
-
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.
-
Arrêtez la migration :
-
Vérifiez le statut de la migration avec l'appel API de l'étape 5 :
Selon les cas, l'appel renvoie le statut
doneou une erreurBad Request.WarningLe statut
donene 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 surperformance_schema.replication_connection_statusne renvoie plusONet qu'une écriture faite sur la source n'arrive plus sur votre service. -
Recréez les utilisateurs de votre application sur votre service OVHcloud, depuis l'onglet
Utilisateursde la console OVHcloud ou en SQL, et attribuez-leur les privilèges dont ils ont besoin. -
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).
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.