LLI Wiki — My Digital Knowledge Base

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 :

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.

  1. 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.
  2. Elle produit un INSERT par 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();
  1. 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 :

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

  1. Exécuter le script post-migration (02_POST_MIG_xx.ps1).
  2. Supprimer les exclusions batch créées pour cette migration (même valeur de motif). Exécuter d'abord un SELECT pour confirmer que les lignes correspondent aux tenants et pools de ce lot, puis un DELETE limité à ces lignes. Ne jamais supprimer toutes les lignes portant le motif de migration sans vérification.
  3. Retirer les deux annotations de pause KEDA de chaque ScaledObject ; KEDA reprend l'autoscaling normal.
  4. 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.
  5. 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

Remarques

Mastodon LLIMastodon SocialFosstodon