Comment définir et démarrer un travail de migration

Lorsque vous migrez un partage vers Azure, vous devez décrire le partage source, la cible Azure et les paramètres de migration que vous souhaitez appliquer. Ces attributs sont définis dans une définition de travail au sein de votre ressource Storage Mover. Cet article explique comment créer et exécuter ce type de définition de travail.

Prérequis

Avant de commencer à suivre les exemples de cet article, vous devez bien comprendre la hiérarchie des ressources Azure Storage Mover. Passez en revue l’article Présentation de la hiérarchie des ressources Storage Mover pour comprendre la nécessité des prérequis de la définition de travail.

Il y a trois prérequis pour définir la migration de vos partages sources :

• Ressource de déplacement de stockage existante.
  Si vous n’avez pas déployé de ressource de mover de stockage, suivez les étapes décrites dans l’article Créer une ressource de déplacement de stockage. Ces étapes vous aident à déployer une ressource de déplacement de stockage dans la région souhaitée dans votre abonnement Azure.
• Au moins une machine virtuelle de l’agent Mover existante Stockage Azure.
  Les étapes du déploiement de la machine virtuelle de l’agent Mover et des articles d’inscription d’agent Stockage Azure vous guident tout au long du processus de déploiement et d’inscription.
• Enfin, vous devez créer une définition de travail pour définir une migration.
  Les définitions de travail sont organisées dans un projet de migration. Vous avez besoin d’au moins un projet de migration dans votre ressource de déplacement de stockage. Si ce n’est déjà fait, suivez les étapes de déploiement de l’article gérer les projets pour créer un projet de migration.

Créer et lancer une définition de travail

Une définition de travail est créée dans une ressource de projet. La création d’une définition de tâche vous oblige à sélectionner ou configurer un projet, des points de terminaison de stockage source et cible, ainsi qu’un nom de travail. Si vous avez suivi les exemples contenus dans les articles précédents, vous pouvez avoir un projet existant au sein d’une ressource de déplacement de stockage précédemment déployée. Suivez les étapes décrites dans cette section pour ajouter une définition de travail à un projet.

Les points de terminaison de stockage sont des ressources distinctes dans votre moteur de migration de stockage. Vous devez créer un point de terminaison source et cible avant de pouvoir les référencer dans une définition de travail. Les exemples de cette section décrivent le processus de création de points de terminaison.

Pour obtenir de l’aide sur le choix des noms de ressources pris en charge, reportez-vous à l’article de convention d’affectation de noms de ressources.

Azure portal

1. Accédez à la page Explorateur de projets dans le portail Azure pour voir la liste des projets disponibles. S’il n’existe aucun projet ou si vous devez créer un nouveau projet, vous pouvez suivre les étapes décrites dans l’article Gérer les projets Azure Storage Mover.

   

   Dans le volet de l’Explorateur de projets ou dans la liste des résultats, sélectionnez le nom d’un projet disponible. Les propriétés du projet et les données récapitulatives du travail s’affichent dans le volet Détails. Toutes les définitions de travaux existantes et les travaux déployés définis pour le projet sont également affichés.

   Dans le menu Actions du volet d’informations du projet, sélectionnez Créer une définition de tâche pour ouvrir la fenêtre Créer un travail de migration. Si aucune définition de travail n’existe dans le projet, vous pouvez également sélectionner Créer une définition de travail en bas du volet, comme illustré dans l’exemple suivant.

   

2. Sous l’onglet Informations de base de la fenêtre Créer un travail de migration, entrez une valeur dans le champ Nom obligatoire. Vous pouvez également ajouter une valeur de description facultative de moins de 1 024 caractères. Enfin, dans la section Agent de migration, sélectionnez l’agent pour effectuer la migration des données, puis sélectionnez Suivant pour ouvrir l’onglet Source. Vous devriez choisir un agent situé aussi près que possible de votre source de données. L’agent sélectionné devrait également disposer de ressources appropriées à la taille et à la complexité du travail. Vous pourrez affecter un autre agent à votre travail ultérieurement si vous le souhaitez.

   

3. Sous l’onglet Source, dans le champ Point de terminaison source, sélectionnez une option. Vous pouvez choisir d’utiliser un point de terminaison source existant ou de créer une ressource de point de terminaison.

   Si vous souhaitez utiliser un point de terminaison source existant que vous avez défini précédemment, choisissez l’option Sélectionner un point de terminaison existant. Ensuite, choisissez le lien Sélectionner un point de terminaison existant en tant que source pour ouvrir le volet du point de terminaison source. Ce volet affiche une liste détaillée de vos points de terminaison précédemment définis. Sélectionnez le point de terminaison approprié, puis choisissez Sélectionner pour revenir à l’onglet Source et remplir le champ Point de terminaison source existant.

   

   Pour définir un nouveau point de terminaison source à partir duquel migrer vos données, sélectionnez l’option Créer un point de terminaison . Ensuite, fournissez des valeurs pour les champs obligatoires Nom d’hôte ou adresse IP, Nom de partage et Version du protocole. Vous pouvez également ajouter une valeur de description facultative de moins de 1 024 caractères.

   

   Seuls certains types de points de terminaison peuvent être utilisés en tant que source ou cible, respectivement. Les étapes de création de différents types de points de terminaison sont similaires, comme les champs de données correspondants. Le différentiateur de clé entre la création de points de terminaison NFS et S Mo est l’utilisation d’Azure Key Vault pour stocker les informations d’identification partagées pour les ressources S Mo. Lorsque vous créez une ressource de point de terminaison qui prend en charge le protocole S Mo, vous devez également fournir des valeurs pour le nom du coffre de clés, ainsi que les noms des secrets de nom d’utilisateur et de mot de passe.

   Sélectionnez le nom du coffre de clés dans les listes déroulantes Key Vault . Vous pouvez fournir des valeurs pour le secret pour le nom d’utilisateur et le secret pour mot de passe en sélectionnant le secret approprié dans la liste déroulante correspondante. Vous pouvez également fournir l’URI au secret, comme indiqué dans la capture d’écran suivante.

   Pour plus d’informations sur les ressources de point de terminaison, consultez l’article Gestion Stockage points de terminaison Mover.

   

   Par défaut, les travaux de migration commencent à partir de la racine de votre partage. Toutefois, si votre cas d’usage implique la copie de données à partir d’un chemin spécifique au sein de votre partage source, vous pouvez fournir le chemin dans le champ Sous-chemin d’accès. L’approvisionnement de cette valeur démarre la migration des données à partir de l’emplacement que vous avez spécifié. Si le sous-chemin que vous avez spécifié n’est pas trouvé, aucune donnée n’est copiée.

   Avant de créer un point de terminaison et une ressource de travail, il est important de vérifier que le chemin que vous avez fourni est correct et que les données sont accessibles. Vous ne pouvez pas modifier des points de terminaison ou des ressources de travail après leur création. Si le chemin spécifié est incorrect, votre seule option consiste à supprimer les ressources et à les recréer.

   Les valeurs de l’hôte, du nom de partage et du sous-chemin sont concaténées pour former le chemin d’accès complet de la source de migration. Le chemin d’accès s’affiche dans le champ Chemin d’accès complet, dans la section Vérifier le chemin d’accès complet. Copiez le chemin fourni et vérifiez que vous êtes en mesure d’y accéder avant de valider vos modifications.

   Après avoir vérifié que le partage est accessible, sélectionnez Suivant pour enregistrer vos paramètres de point de terminaison source et commencer à définir votre cible.

4. Sous l’onglet Cible , sélectionnez une option pour le champ Point de terminaison cible.

   Comme avec le point de terminaison source, choisissez l’option Sélectionner une référence de point de terminaison existante si vous souhaitez utiliser un point de terminaison précédemment défini. Ensuite, choisissez le lien Sélectionner un point de terminaison existant en tant que cible pour ouvrir le volet du point de terminaison cible. Une liste détaillée de vos points de terminaison précédemment définis s’affiche. Dans la liste des points de terminaison, sélectionnez le point de terminaison souhaité, puis sélectionnez cette option pour remplir le champ de point de terminaison source existant et revenir à l’onglet Source .

   

   De même, pour définir un nouveau point de terminaison cible, choisissez l’option Créer un point de terminaison. Ensuite, sélectionnez des valeurs dans les listes déroulantes pour les champs Abonnement requis et Stockage compte. Vous pouvez également ajouter une valeur de description facultative de moins de 1 024 caractères. Selon votre cas d’usage, sélectionnez le type *Cible approprié.

   Rappelez-vous que certains types de points de terminaison ne peuvent être utilisés qu’en tant que source ou cible, respectivement.

   La version actuelle Stockage Azure Mover prend en charge les migrations de fidélité totale pour des combinaisons de paires source-cible spécifiques. Utilisez toujours la dernière version de l’agent pour tirer parti de ces sources et destinations prises en charge :

   Protocole source	Cible	Commentaires
   Montage S Mo 2.x	Partage de fichiers Azure (S Mo)	Les sources S Mo 1.x et les partages de fichiers Azure NFS ne sont actuellement pas pris en charge.
   Montage NFS 3 &4	Conteneur de stockage d’objets blob Azure	Les conteneurs avec la fonctionnalité « Service d’espace de noms hiérarchique (HNS) » activés, sont pris en charge et l’ensemble d’API REST ADLS Gen2 est utilisé pour la migration.

   

   Une valeur de sous-chemin cible peut être utilisée pour spécifier un emplacement dans le conteneur cible où vos données migrées doivent être copiées. La valeur du sous-chemin est relative à la racine du conteneur. Vous pouvez fournir une valeur unique pour générer un nouveau sous-dossier. Si vous omettez la valeur de sous-chemin, les données sont copiées à la racine.

   Après avoir vérifié la précision de vos paramètres, sélectionnez Suivant pour continuer.

5. Sous l’onglet Paramètres, notez les paramètres associés au Mode de copie et aux Résultats de la migration. Le mode de copie du service affecte le comportement du moteur de migration lorsque les fichiers ou dossiers changent entre les itérations de copie.

   Fusionner la source dans la cible :

   • Les fichiers se trouvent dans la cible, même s’ils n’existent pas dans la source.
   • Les fichiers avec des noms et des chemins correspondants sont mis à jour pour correspondre à la source.
   • Les noms de fichiers ou de dossiers entre les copies créent du contenu en double dans la cible.

   Source miroir à cibler :

   • Les fichiers de la cible sont supprimés s’ils n’existent pas dans la source.
   • Les fichiers et dossiers de la cible sont mis à jour pour correspondre à la source.
   • Les noms de fichiers ou de dossiers entre les copies ne génèrent pas de contenu en double. Un élément renommé côté source entraîne la suppression de l’élément avec le nom d’origine dans la cible. En outre, l’élément renommé est également chargé sur la cible. Si l’élément renommé est un dossier, le comportement décrit de suppression et de rechargement s’applique à tous les fichiers et dossiers contenus dans celui-ci. Évitez de renommer des dossiers lors d’une migration, en particulier près du niveau racine de vos données sources.

   Les résultats de la migration sont basés sur les types de stockage spécifiques des points de terminaison source et cible. Par exemple, étant donné que le stockage d’objets blob prend uniquement en charge les dossiers « virtuels », les fichiers sources dans les dossiers ont leurs chemins d’accès ajoutés à leurs noms et placés dans une liste plate dans un conteneur d’objets blob. Les dossiers vides sont représentés sous la forme d’un objet blob vide dans la cible. Les métadonnées du dossier source sont conservées dans le champ de métadonnées personnalisées d’un objet blob, car elles sont avec des fichiers.

   Après avoir affiché les effets du mode de copie et les résultats de la migration, sélectionnez Suivant pour examiner les valeurs des onglets précédents.

6. Passez en revue les paramètres de nom et de description du travail, ainsi que les paramètres des points de terminaison de stockage source et cible. Utilisez les options Précédent et Suivant pour parcourir les onglets et corriger les erreurs éventuelles si nécessaire. Enfin, sélectionnez Créer pour approvisionner la définition de tâche.

   

PowerShell

Vous devez utiliser plusieurs applets de commande pour créer une définition de travail. Comme mentionné précédemment, les points de terminaison source et cible doivent être créés avant qu’ils ne soient référencés par une définition de travail.

Utilisez l’applet de commande New-AzStorageMoverJobDefinition pour créer une ressource de définition de travail dans un projet. Les exemples suivants supposent que vous n’utilisez pas de points de terminaison de stockage que vous avez créés précédemment.

      
##  Set variables
$subscriptionID     = "Your subscription ID"
$resourceGroupName  = "Your resource group name"
$storageMoverName   = "Your storage mover name"

##  Log into Azure with your Azure credentials
Connect-AzAccount -SubscriptionId $subscriptionID

##  Define the source endpoint: an NFS share in this example
##  There is a separate cmdlet for creating each type of endpoint.
##  (Each storage location type has different properties.)
##  Run "Get-Command -Module Az.StorageMover" to see a full list.
$sourceEpName        = "Your source endpoint name could be the name of the share"
$sourceEpDescription = "Optional, up to 1024 characters"
$sourceEpHost        = "The IP address or DNS name of the source share NAS or server"
$sourceEpExport      = "The name of your source share"
##  Note that Host and Export will be concatenated to [Host]:/[Export] to form the full path 
##  to the source NFS share

New-AzStorageMoverNfsEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Name $sourceEpName `
    -Host $sourceEpHost `
    -Export $sourceEpExport `
    -Description $sourceEpDescription # Description optional

##  Define the target endpoint: an Azure blob container in this example
$targetEpName          = "Target endpoint or blob container name"
$targetEpDescription   = "Optional, up to 1024 characters"
$targetEpContainer     = "The name of the target container in Azure"
$targetEpSaResourceId  = /subscriptions/<GUID>/resourceGroups/<name>/providers/`
                         Microsoft.Storage/storageAccounts/<storageAccountName>
##  Note: the target storage account can be in a different subscription and region than
##  the storage mover resource.
##
##  Only the storage account resource ID contains a fully qualified reference.

New-AzStorageMoverAzStorageContainerEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Name $targetEpName `
    -BlobContainerName $targetEpContainer `
    -StorageAccountResourceId $targetEpSaResourceId `
    -Description $targetEpDescription # Description optional

## Create a job definition resource
$projectName        = "Your project name"
$jobDefName         = "Your job definition name"
$JobDefDescription  = "Optional, up to 1024 characters"
$jobDefCopyMode     = "Additive" # Merges source into target. See description in portal tab.
#$jobDefCopyMode    = "Mirror" # Mirrors source into target. See description in portal tab.
$agentName          = "The name of an agent previously registered to the same storage mover resource"


New-AzStorageMoverJobDefinition `
    -Name $jobDefName `
    -ProjectName $projectName `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -CopyMode $jobDefCopyMode `
    -SourceName $sourceEpName `
    -TargetName $targetEpName `
    -AgentName $agentName `
    -Description $sourceEpDescription # Description optional

Étapes suivantes

Maintenant que vous avez créé une définition de tâche avec des points de terminaison source et cible, découvrez comment estimer le temps nécessaire pour effectuer votre travail de migration.

Objectifs de mise à l’échelle et de performances d’Azure Storage Mover