Gérer les projets Azure Storage Mover

Un projet Storage Mover est utilisé pour organiser les travaux de migration en tâches ou composants logiques. Un projet contient au moins une définition de travail, qui décrit à son tour chaque point de terminaison source et cible de votre projet. L’article Présentation de la hiérarchie des ressources Storage Mover contient des informations plus détaillées sur la relation entre une ressource Storage Mover et ses projets.

Quand vous définissez un projet, ajoutez toutes les sources de données dépendantes associées dans le même projet pour qu’elles puissent être migrées ensemble. Ajoutez toutes les sources de données nécessaires pour migrer une seule charge de travail au lieu de créer des projets pour chaque source de données dans votre plan de migration. Vous pouvez également choisir de créer des projets individuels pour chaque groupe distinct de sources de données dans votre plan de migration.

Cet article vous guide tout au long de la création et de la gestion des projets Azure Storage Mover. Pour suivre ces exemples, vous avez besoin d’une ressource Storage Mover de niveau supérieur. Si vous n’en avez pas encore créé une, suivez les étapes décrites dans l’article Créer une ressource Storage Mover avant de continuer.

Une fois que vous avez effectué les étapes décrites dans cet article, vous pouvez créer et gérer des projets en utilisant le portail Azure et Azure PowerShell.

Créer un projet

La première étape de définition d’un travail de migration est la création d’une ressource de projet. Une fois le projet créé, vous pouvez ajouter des points de terminaison source et cible pour votre source de données. Dans cet exemple, vous laissez intentionnellement le champ description vide. Vous l’ajoutez par la suite dans la section Voir et modifier les propriétés d’un projet plus loin dans cet article.

Important

Si vous n’avez pas encore déployé de ressource avec le fournisseur de ressources, vous devez créer votre ressource de niveau supérieur.

Attention

Le renommage des ressources de projet n’est pas pris en charge. Vérifiez que vous avez nommé le projet de manière appropriée, car vous ne pouvez pas changer le nom du projet après son provisionnement.

Azure portal

1. Accédez à la page Explorateur de projets dans le portail Azure pour accéder à vos projets. La vue par défaut Tous les projets affiche les noms des projets provisionnés et un récapitulatif des travaux qu’ils contiennent.

   

2. Sélectionnez Créer un projet pour ouvrir le volet Créer un projet. Indiquez une valeur de nom de projet dans le champ Nom du projet, mais laissez le champ Description du projet vide. Enfin, sélectionnez Créer pour provisionner le projet.

   

PowerShell

La création d’un projet vous oblige à choisir un nom. Consultez la convention de nommage des ressources pour choisir un nom pris en charge. La description est facultative et peut contenir jusqu’à 1024 caractères mono-octets.

L’applet de commande New-AzStorageMoverProject est utilisée pour créer un projet dans une ressource Storage Mover que vous avez déployée précédemment. Si vous n’avez pas encore installé le module Az.StorageMover :

## Ensure you are running the latest version of PowerShell 7
$PSVersionTable.PSVersion

## Your local execution policy must be set to at least remote signed or less restrictive
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

## If you don't have the general Az PowerShell module, install it first
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

## Lastly, the Az.StorageMover module is not installed by default and must be manually requested.
Install-Module -Name Az.StorageMover -Scope CurrentUser -Repository PSGallery -Force

L’article Installer Azure PowerShell contient plus de détails.

Vous devez fournir des valeurs pour les paramètres -Name, -ResourceGroupName et -StorageMoverName obligatoires. Le paramètre -Description est facultatif.

1. Pensez à créer et utiliser des variables pour stocker les chaînes longues ou potentiellement complexes.

   
   ## Set variables
   $subscriptionID     = "Your subscription ID GUID"
   $resourceGroupName  = "demoResourceGroup"
   $storageMoverName   = "demoMover"
   $projectName        = "demoProject"
   $projectDescription = ""
   
   

2. Connectez-vous à votre compte Azure en utilisant l’applet de commande Connect-AzAccount. Spécifiez l’ID de votre abonnement en fournissant une valeur pour le paramètre -Subscription, comme indiqué dans l’exemple.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. Une fois connecté, vous pouvez utiliser l’applet de commande New-AzStorageMoverProject pour créer votre projet, comme illustré dans l’exemple suivant.

   
   New-AzStorageMoverProject `
      -ResourceGroupName $resourceGroupName `
      -StorageMoverName $storageMoverName `
      -Name $projectName `
      -Description $projectDescription
   
   

   L’exemple de réponse suivant contient la propriété ProvisioningState dont la valeur indique que le projet a été créé avec succès.

   
   Description                  : This is a project used for demonstration.
   Id                           : /subscriptions/<GUID>/resourceGroups/
                                 demoResourceGroup/providers/Microsoft.StorageMover/storageMovers/
                                 demoMover/projects/demoProject
   Name                         : testingAgain
   ProvisioningState            : Succeeded
   SystemDataCreatedAt          : 8/17/2022 1:19:00 AM
   SystemDataCreatedBy          : user@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 8/17/2022 1:19:00 AM
   SystemDataLastModifiedBy     : user@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : microsoft.storagemover/storagemovers/projects
   
   

Voir et modifier les propriétés d’un projet

Selon votre cas d’usage, vous devez peut-être récupérer un projet spécifique ou la liste complète de toutes vos ressources de projet. Vous devez peut-être aussi ajouter ou modifier la description d’un projet.

Suivez les étapes de cette section pour voir les projets accessibles à votre ressource Storage Mover.

Azure portal

1. Accédez à la page Explorateur de projets dans le portail Azure pour voir la liste des projets disponibles. Vous pouvez créer et appliquer des filtres pour limiter ou mettre en forme votre vue. Pour affiner l’étendue des résultats, vous pouvez ajouter d’autres filtres.

   

   Les filtres peuvent également être modifiés ou supprimés si nécessaire, comme indiqué dans l’exemple ci-dessous. Actuellement, seul le filtrage des projets par nom est pris en charge.

   

2. Dans le volet Explorateur de projets ou dans la liste des résultats, sélectionnez le nom du projet créé dans la section précédente. Les propriétés du projet et les données récapitulatives du travail s’affichent dans le volet Détails.

   Si le projet n’a pas de description valide, sélectionnez Ajouter une description pour afficher le volet Modifier la description.

   

   Si une description existe, elle s’affiche sous le titre Description. Sélectionnez l’icône Modifier à côté de la description ou de l’icône Modifier la description pour afficher le volet d’édition. L’image ci-dessous montre l’emplacement des deux icônes.

   

3. Dans le volet d’édition, modifiez la description de votre projet. En bas du volet, sélectionnez Enregistrer pour valider vos changements.

   

PowerShell

1. Utilisez l’applet de commande Get-AzStorageMoverProject pour récupérer la liste des ressources de projet. Vous pouvez aussi fournir une valeur de paramètre -Name pour récupérer une ressource de projet spécifique. L’appel de l’applet de commande sans le paramètre facultatif retourne la liste de tous les projets provisionnés dans votre groupe de ressources.

   L’exemple suivant récupère une ressource de projet spécifique en spécifiant la valeur demoProject.

   
     Get-AzStorageMoverProject `
       -ResourceGroupName $resourceGroupName `
       -StorageMoverName $storageMoverName `
       -Name "demoProject" 
   
   

   L’exemple de réponse ci-dessous contient les propriétés du projet spécifié, y compris la Description vide.

   
      Description                  :
      Id                           : /subscriptions/<GUID>/resourceGroups/
                                     demoResourceGroup/providers/Microsoft.StorageMover/storageMovers/
                                     demoMover/projects/demoProject
      Name                         : demoProject
      ProvisioningState            : Succeeded
      SystemDataCreatedAt          : 7/15/2022 6:22:51 PM
      SystemDataCreatedBy          : user@contoso.com
      SystemDataCreatedByType      : User
      SystemDataLastModifiedAt     : 8/16/2022 10:36:52 PM
      SystemDataLastModifiedBy     : user@contoso.com
      SystemDataLastModifiedByType : User
      Type                         : microsoft.storagemover/storagemovers/projects   
   
   

2. Pour ajouter la description manquante au projet renvoyé par l’applet de commande, vous devez utiliser l’applet de commande Update-AzStorageMoverProject. Dans cette instance, toutefois, les paramètres -ResourceGroupName, -StorageMoverName et -Name sont tous obligatoires. Vous pouvez également fournir la valeur de Description du projet manquante avec le paramètre -Description, comme illustré dans l’exemple suivant.

   
   Update-AzStorageMoverProject `
      -Name demoProject `
      -ResourceGroupName $resourceGroupName `
      -StorageMoverName $storageMoverName `
      -Description "Demo project managed with PowerShell."
   
   

   L’élément ProvisioningState inclus dans la réponse confirme que le projet a été correctement mis à jour.

   
     Description                  : Demo project managed with PowerShell.
     Id                           : /subscriptions/<GUID>/resourceGroups/
                                     demoResourceGroup/providers/Microsoft.StorageMover/storageMovers/
                                     demoMover/projects/demoProject
     Name                         : demoProject
     ProvisioningState            : Succeeded
     SystemDataCreatedAt          : 7/15/2022 6:22:51 PM
     SystemDataCreatedBy          : user@contoso.com
     SystemDataCreatedByType      : User
     SystemDataLastModifiedAt     : 8/24/2022 7:47:50 AM
     SystemDataLastModifiedBy     : user@contoso.com
     SystemDataLastModifiedByType : User
     Type                         : microsoft.storagemover/storagemovers/projects
   
   

Supprimer un projet

La suppression d’une ressource de projet doit rester une exception dans votre environnement de production, même si cela peut être utile à certaines occasions. Pour supprimer une ressource de projet Storage Mover, suivez l’exemple fourni.

Avertissement

La suppression d’un projet est une action définitive qui ne peut pas être annulée. Vérifiez que vous êtes prêt à supprimer le projet, car vous ne pouvez pas le restaurer par la suite.

Azure portal

1. Accédez à la page Explorateur de projets dans le portail Azure pour voir vos projets et un récapitulatif des travaux qu’ils contiennent.

   

2. Tout d’abord, dans le volet Explorateur de projets ou dans la liste des résultats, sélectionnez le nom du projet à supprimer. Ensuite, sélectionnez Supprimer le projet dans le volet Détails du projet. Enfin, dans la boîte de dialogue Confirmer la suppression du projet, sélectionnez Supprimer pour supprimer définitivement votre projet. Passez en revue les sélections mises en surbrillance dans l’image suivante si nécessaire.

   

Avertissement

La suppression d’un projet supprime toutes les définitions de travail qu’il contient, leur historique d’exécution et les résultats. La suppression de ces ressources est définitive et ne peut pas être annulée. Les points de terminaison de stockage ne sont pas affectés.

PowerShell

Utilisez Remove-AzStorageMoverProject pour supprimer définitivement une ressource de projet. Indiquez le nom du projet avec le paramètre -Name, et les noms du groupe de ressources et de la ressource Storage Mover avec les paramètres -ResourceGroupName et -StorageMoverName, respectivement.

Remove-AzStorageMoverProject `
   -Name $projectName `
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName

Avertissement

La suppression d’un projet supprime toutes les définitions de travail qu’il contient, leur historique d’exécution et les résultats. La suppression de ces ressources est définitive et ne peut pas être annulée. Les points de terminaison de stockage ne sont pas affectés.

Étapes suivantes

Une fois vos projets créés, vous pouvez commencer à utiliser les définitions de travail.

Définir un travail de migration