Partager via

Guide pratique pour configurer Azure CLI pour le service de migration dans Azure Database pour PostgreSQL – Serveur flexible

  • Article

Azure CLI est un ensemble de commandes utilisées dans les services Azure pour créer et gérer des ressources. Il fournit les mêmes fonctionnalités que le portail Azure, mais est optimisé pour les utilisateurs qui préfèrent travailler dans un environnement de ligne de commande. Pour commencer la migration à l’aide d’Azure CLI, vous devez installer l’interface de ligne de commande Azure sur votre ordinateur local.

Prérequis

  • Installez Azure CLI : en fonction de votre système d’exploitation, téléchargez et installez Azure CLI. Il est disponible pour Windows, macOS et Linux.
  • Guide d’installation d’Azure CLI : suivez les instructions fournies dans la documentation Azure officielle pour installer Azure CLI – Guide pratique pour installer Azure CLI.
  • Vérifiez la version d’Azure CLI : vérifiez que votre version d’Azure CLI est au moins 2.56.0, car ceci est un prérequis pour le service de migration. Utilisez la commande az --version pour vérifier la version actuelle.
  • Connectez-vous à Azure : après l’installation, exécutez az login pour vous authentifier. Cela ouvre votre navigateur par défaut pour terminer le processus de connexion avec vos informations d’identification Azure.

Ces étapes préparent votre environnement à l’utilisation d’Azure CLI pour gérer efficacement le service de migration dans Azure Database pour PostgreSQL. Reportez-vous toujours à la documentation Azure la plus récente pour connaître toutes les mises à jour ou modifications apportées au processus d’installation.

Configurer les commandes CLI pour le service de migration

Toutes les commandes d’interface de ligne de commande commencent par az postgres flexible-server migration. Des instructions d’aide sont également fournies pour vous aider à comprendre les différentes options et à définir la syntaxe correcte pour les commandes CLI.

Une fois la CLI installée, ouvrez l’invite de commandes et connectez-vous au compte Azure à l’aide de la commande ci-dessous.

az login

Commandes de migration

Le service de migration fournit les commandes suivantes pour vous aider à migrer vos instances PostgreSQL vers Azure Database pour PostgreSQL – Serveur flexible.

Commande help

La commande --help dans Azure CLI est une option précieuse qui fournit une documentation détaillée sur les commandes et leurs sous-commandes, y compris les verbes requis pour les opérations. La commande –-help affiche les commandes nécessaires et leurs actions associées pour le service de migration dans Azure Database pour PostgreSQL.

az postgres flexible-server migration –-help

La sortie vous guide tout au long des étapes et paramètres nécessaires pour gérer efficacement vos migrations de base de données à l’aide d’Azure CLI.

commande Create

La commandeaz postgres flexible-server migration create dans Azure CLI sert à lancer un nouveau flux de travail de migration. Elle facilite la migration des bases de données d’une instance PostgreSQL source vers une instance Azure Database pour PostgreSQL – Serveur flexible cible. Cette commande configure les paramètres nécessaires pour garantir un processus de migration fluide et efficace.

Pour plus d’informations, consultez az postgres flexible-server migration create.

Commande list

La commande az postgres flexible-server migration list sert à répertorier toutes les tentatives de migration effectuées vers une cible Azure Database pour PostgreSQL. Cette commande fournit une vue d’ensemble des migrations qui ont été lancées, ce qui vous permet de suivre l’état et les détails de chaque tentative de migration.

Pour plus d’informations, consultez az postgres flexible-server migration list.

Commande show

La commande az postgres flexible-server migration show permet de surveiller les migrations en cours et fournit l’état et le sous-état actuels de la migration. Ces détails incluent des informations sur l’état et le sous-état actuels de la migration.

Pour plus d’informations, consultez az postgres flexible-server migration show.

Les états de migration possibles incluent :

États de migration

State Description
InProgress L’infrastructure de migration est en cours de configuration, ou la migration des données est en cours.
Annulé La migration est annulée ou supprimée.
Échec La migration a échoué.
Échec de la validation La validation a échoué.
Réussi La migration a réussi et est terminée.
WaitingForUserAction Applicable uniquement pour la migration en ligne. Attente d’une action de l’utilisateur pour effectuer le basculement.

Sous-états de la migration

Sous-état Description
PerformingPreRequisiteSteps L’infrastructure est en cours de configuration pour la migration des données.
Validation en cours La validation est en cours.
MigratingData La migration des données est en cours.
CompletingMigration La migration est en phase finale.
Terminé La migration est terminée.
Échec La migration a échoué.

Sous-états de validation

Sous-état Description
Échec La validation a échoué.
Réussi La validation a réussi.
Avertissement La validation présente un avertissement.

Commande de mise à jour

La commande az postgres flexible-server migration update sert à gérer le processus de migration vers un serveur flexible Azure Database pour PostgreSQL. Plus précisément, vous pouvez l’utiliser pour :

  • Effectuer un basculement : cela finalise le processus de migration en basculant le trafic de base de données du serveur source vers le serveur flexible cible.
    • Une fois la migration des données de base terminée, la tâche de migration bascule au sous-état WaitingForCutoverTrigger. Dans cet état, les utilisateurs peuvent déclencher le basculement à partir du portail en sélectionnant le nom de la migration dans la grille de migration ou via l’interface CLI.
    • Avant de lancer le basculement, il est important de s’assurer que :
      • Les écritures dans la source sont arrêtées
      • La valeur de latency diminue à 0 ou proche de 0
      • La valeur de latency indique quand la cible a été synchronisée pour la dernière fois avec la source. À ce stade, les écritures dans la source peuvent être arrêtées et le basculement peut être lancé. Si le trafic est important au niveau de la source, nous vous recommandons d’arrêter d’abord les écritures afin que Latency puisse atteindre une valeur proche de 0, puis de lancer le basculement.
      • L’opération de basculement applique toutes les modifications en attente de la source vers la cible, et termine la migration. Si vous déclenchez un « basculement » avec un paramètre Latency différent de zéro, la réplication s’arrête jusqu’à ce point dans le temps. Toutes les données de la source jusqu’au point de basculement sont ensuite appliquées à la cible. Si, par exemple, la latence est de 15 minutes au point de basculement, tous les changements de données des 15 dernières minutes sont appliqués à la cible.
  • Annuler la migration : si nécessaire, cette option vous permet d’arrêter le processus de migration.
  • Configurer la réplication logique à la source : cette option est utile lorsque le serveur source est un serveur Azure Database pour PostgreSQL – Serveur unique, car cela prépare le serveur pour la réplication des données vers le serveur flexible.

Pour plus d’informations, consultez az postgres flexible-server migration update.

Résumé

Le tableau suivant récapitule les paramètres utilisés par les commandes de migration :

Paramètre Commandes pertinentes Description
subscription create, list, show, update ID d’abonnement du serveur flexible PostgreSQL
resource-group create, list, show, update Groupe de ressources du serveur flexible PostgreSQL
name create, list, show Nom du serveur flexible PostgreSQL
migration-name create, show, update Identificateur unique aux migrations tentées vers le serveur flexible. Ce champ accepte uniquement les caractères alphanumériques et n’accepte aucun caractère spécial à l’exception du trait d’union (-). Le nom ne peut pas commencer par - et deux migrations vers un serveur flexible ne peuvent pas avoir le même nom.
filter list Pour filtrer les migrations, deux valeurs sont prises en charge : Active et All
help create, list, show, update Donne des informations sur chaque commande.
migration-mode create Il s'agit d'un paramètre facultatif. Les valeurs autorisées sont : offline, online. Valeur par défaut : hors connexion.
migration-option create Vous permet d’effectuer des validations avant de déclencher une migration. La valeur par défaut est ValidateAndMigrate. Les valeurs autorisées sont : Migrate, Validate, ValidateAndMigrate.
properties create Chemin absolu d’un fichier JSON qui contient les informations sur le serveur source, le serveur cible, les bases de données à migrer, les modes SSL, la définition des types sources

Détails du fichier JSON

La commande az postgres flexible-server migration create nécessite un chemin d’accès au fichier JSON dans le cadre du paramètre --properties, qui contient des détails de configuration pour la migration, tels que l’ID de ressource du serveur de base de données source, les informations d’identification de l’administrateur, les bases de données à migrer et d’autres paramètres importants. Voici les différentes propriétés :

Nom de la propriété Description
sourceDbServerResourceId Informations du serveur source au format local, machines virtuelles, service PostgreSQL cloud : <<hostname or IP address>>:<<port>>@<<username>>. Si le serveur source est Azure Database pour PostgreSQL – Serveur unique, l’ID de ressource est au format /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>.
adminCredentials Ce paramètre répertorie les mots de passe des utilisateurs administrateurs pour le serveur source et le serveur flexible PostgreSQL cible. Ces mots de passe permettent d’effectuer une authentification auprès des serveurs source et cible. Il comprend deux sous-propriétés, sourceServerPassword et targetServerPassword.
targetServerUserName La valeur par défaut correspond à l’utilisateur administrateur créé lors de la création du serveur flexible cible PostgreSQL, et le mot de passe fourni est utilisé pour l’authentification par rapport à cet utilisateur.
dbsToMigrate Spécifiez la liste des bases de données que vous souhaitez migrer vers le serveur flexible. Vous pouvez inclure un maximum de 8 noms de base de données à la fois. Fournir la liste des bases de données au format tableau.
overwriteDBsInTarget Lorsque la valeur est « true » (valeur par défaut), si le serveur cible a une base de données existante portant le même nom que celle que vous essayez de migrer, le service de migration remplace automatiquement la base de données.
migrationRuntimeResourceId Obligatoire si un serveur d’exécution doit être utilisé pour la migration. Le format est : /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Paramètre obligatoire. Les valeurs possibles sont : sur site, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Modes SSL pour la migration. Le mode SSL pour PostgreSQLSingleServer est VerifyFull et Prefer/Require pour d’autres types de source.

Contenu connexe