Migrer des bases Azure SQL entre pools élastiques et groupes de basculement avec pause KEDA
Runbook générique : contrôle de la géo-réplication, exclusion des traitements batch, pause KEDA, migration, mise à jour du registre des emplacements et reprise.
Ce runbook décrit une méthode pour déplacer des bases Azure SQL entre pools élastiques ou serveurs appartenant à des groupes de basculement, pendant que les applications qui les utilisent sont mises à l'arrêt. Les étapes : vérifier la géo-réplication, bloquer les traitements batch des tenants concernés, mettre en pause les workloads pilotés par KEDA, exécuter la migration, mettre à jour le registre des emplacements, puis tout relancer.
Vue d'ensemble
Le scénario est une application multi-tenant. Chaque tenant possède sa propre base, hébergée dans un pool élastique. Une base centrale « admin » contient une table d'emplacements qui indique aux applications quel serveur et quel pool chaque tenant utilise. Les bases des tenants sont protégées par des groupes de basculement (FOG) : les applications se connectent donc via le nom DNS du groupe de basculement.
Les scripts de migration sont organisés par lot de pools élastiques :
| Phase | Modèle de script | Rôle |
|---|---|---|
| Pré-migration | 00_PRE_MIG_xx.ps1 |
Préparation avant la bascule |
| Migration | 01_MIG_xx.ps1 |
Exécute le déplacement / la bascule |
| Reprise | 01_MIG_FAILED_xx.ps1 |
Traite les bases en échec lors de la phase normale |
| Post-migration | 02_POST_MIG_xx.ps1 |
Opérations après la bascule |
Un fichier de paramètres partagé (script PowerShell) contient la correspondance : noms des bases, pools élastiques actuels et cibles, serveurs actuels et cibles (abonnement, groupe de ressources, nom de serveur), serveurs partenaires et partenaires secondaires, nouveaux noms de groupes de basculement, ainsi qu'un paramètre ValidateSet("test", "real") pour exécuter en mode test ou réel. Le vérifier avant chaque exécution.
1. Vérifier la géo-réplication avant la bascule
Exécuter un script d'état sur le serveur source avant et après la migration. Il peut s'appuyer sur ces vues Azure SQL :
sys.geo_replication_linkssys.databasessys.database_service_objectivessys.dm_geo_replication_link_statussys.dm_operation_status
Par exemple, pour lister les opérations en cours et récentes :
SELECT *
FROM sys.dm_operation_status
ORDER BY start_time DESC;
Cela permet de vérifier l'état de réplication, les rôles primaire/secondaire, le serveur partenaire, le pool élastique de chaque base, et qu'aucune opération Azure SQL n'est encore en cours.
Dans le portail Azure, ouvrir le serveur SQL puis Groupes de basculement (Failover groups) et contrôler le nom du groupe, les serveurs primaire et secondaire, les bases qui en font partie, la stratégie de basculement et son état. Les fichiers de configuration montrent ce qui devrait exister ; le portail montre ce qui existe réellement.
2. Exclure les tenants concernés des traitements batch
Plutôt que d'arrêter toute l'infrastructure batch, insérer les tenants concernés dans une table d'exclusion lue par le moteur batch (ici dbo.batch_exclu), avec un motif dédié pour pouvoir identifier ces lignes ensuite.
- Sur la base admin, exécuter une requête génératrice sur la table d'emplacements, filtrée sur la liste des pools élastiques du lot en cours.
- Elle produit un
INSERTpar tenant, par exemple :
INSERT INTO dbo.batch_exclu
(
[tenant_id],
[application_id],
[reason],
[last_user],
[last_date]
)
SELECT
'TENANT01',
'MIGRATION_APP',
'DB_MIGRATION',
'migration_user',
GETDATE();
- Relire les instructions générées, puis les exécuter sur la base batch. À faire bien avant le début de la fenêtre batch le jour de la migration.
3. Mettre en pause les workloads pilotés par KEDA
Les applications qui continuent de traiter des données dans les bases des tenants (passerelles de messages, moteurs de documents, moteurs d'export...) doivent être arrêtées avant la bascule. Lorsqu'elles sont mises à l'échelle par KEDA, il faut mettre en pause le ScaledObject plutôt que modifier le déploiement à la main, sinon KEDA le remonte.
Dans une interface Kubernetes (ou avec kubectl edit scaledobject <nom> -n <namespace>), ajouter ces annotations sur chaque ScaledObject :
metadata:
annotations:
autoscaling.keda.sh/paused: "true"
autoscaling.keda.sh/paused-replicas: "0"
| Annotation | Effet |
|---|---|
autoscaling.keda.sh/paused: "true" |
Met en pause l'autoscaling KEDA |
autoscaling.keda.sh/paused-replicas: "0" |
Force le workload à 0 réplica |
Avant de lancer la bascule, vérifier que tous les workloads concernés sont à 0 réplica.
4. Exécuter la migration
Lancer le script de migration du lot (01_MIG_xx.ps1). Si certaines bases échouent, analyser puis utiliser le script de reprise (01_MIG_FAILED_xx.ps1).
5. Valider les bases
Relancer le script d'état de géo-réplication et contrôler les groupes de basculement dans le portail :
- les bases existent sur l'infrastructure attendue ;
- le primaire et le secondaire sont ceux attendus et la réplication est saine ;
- le groupe de basculement et le pool élastique sont ceux attendus ;
- aucune opération Azure SQL n'est en cours de façon inattendue.
6. Mettre à jour le registre des emplacements
Une fois les bases déplacées, mettre à jour la table d'emplacements de la base admin pour que les applications résolvent les tenants migrés via le nouveau groupe de basculement. Point important : la colonne serveur ne désigne pas un serveur physique mais le nom DNS du groupe de basculement.
UPDATE dbo.TenantLocation
SET ServerName = 'myfog.database.windows.net,1433',
Elastic_pool_name = 'sqlelp-new-01-28',
env = REPLACE(REPLACE([env], 'GB', 'FG'), 'BC', 'FG')
WHERE ServerName LIKE 'oldserver.database.windows.net%'
AND Elastic_pool_name = 'sqlelp-old-28';
GO
Répéter l'instruction pour chaque pool élastique du lot. Avant de relancer quoi que ce soit, vérifier qu'aucun tenant migré ne référence encore l'ancien serveur ou l'ancien pool, et que le nouveau DNS de groupe de basculement, le pool et la valeur d'environnement sont corrects.
7. Post-migration puis reprise
- Exécuter le script post-migration (
02_POST_MIG_xx.ps1). - Supprimer les exclusions batch créées pour cette migration (même valeur de motif). Exécuter d'abord un
SELECTpour confirmer que les lignes correspondent aux tenants et pools de ce lot, puis unDELETElimité à ces lignes. Ne jamais supprimer toutes les lignes portant le motif de migration sans vérification. - Retirer les deux annotations de pause KEDA de chaque
ScaledObject; KEDA reprend l'autoscaling normal. - Valider les applications : pods en cours d'exécution, pas de CrashLoop, autoscaling KEDA actif, traitement repris, aucune erreur de connexion vers les bases migrées.
- Valider le batch : plus d'exclusion pour les tenants, traitement repris, pas d'erreur de connexion, aucune référence à d'anciens noms de serveur ou de pool.
Check-list
- [ ] Fichier de paramètres vérifié (bases, pools, serveurs cibles, groupes de basculement)
- [ ] État de géo-réplication et groupes de basculement contrôlés
- [ ] Exclusions batch générées, relues et insérées
- [ ] Workloads KEDA en pause et à 0 réplica
- [ ] Script de migration exécuté (script de reprise si nécessaire)
- [ ] Géo-réplication et groupes de basculement validés
- [ ] Registre des emplacements mis à jour et vérifié
- [ ] Script post-migration exécuté
- [ ] Exclusions batch supprimées (uniquement les lignes de ce lot)
- [ ] Pause KEDA retirée et applications validées
Remarques
- Les noms de serveurs, bases, pools, tenants, applications et scripts sont des exemples génériques.
- La source n'a pas vérifié l'instruction
DELETEexacte utilisée en production pour retirer les exclusions ; toujours faire unSELECTd'abord.