Zarządzanie projektami usługi Azure Storage Mover

Projekt Storage Mover służy do organizowania zadań migracyjnych w logiczne zadania lub komponenty. Projekt zawiera co najmniej jedną definicję zadania, która z kolei opisuje każde źródło danych i docelowy punkt końcowy projektu. Artykuł Understanding the Storage Mover resource hierarchy (Opis hierarchii zasobów usługi Storage Mover ) zawiera bardziej szczegółowe informacje na temat relacji między usługą Storage Mover i jego projektami.

Podczas definiowania projektu dobrym pomysłem jest dodanie wszystkich powiązanych, zależnych od siebie źródeł danych do tego samego projektu, aby można je było migrować razem. Należy dodać wszystkie źródła danych niezbędne do migracji pojedynczego obciążenia, a nie utworzyć projektów dla każdego źródła danych w planie migracji. Możesz również utworzyć poszczególne projekty dla każdej odrębnej grupy źródeł danych w planie migracji.

Ten artykuł przeprowadzi Cię przez proces tworzenia projektów usługi Azure Storage Mover i zarządzania nimi. Aby postępować zgodnie z tymi przykładami, potrzebny będzie zasób magazynu najwyższego poziomu. Jeśli nie utworzyłeś jeszcze zasobu Mover magazynu, przed kontynuowaniem wykonaj kroki opisane w artykule Tworzenie zasobu Mover magazynu.

Po wykonaniu kroków opisanych w tym artykule będzie można tworzyć projekty i zarządzać nimi przy użyciu witryny Azure Portal i programu Azure PowerShell.

Tworzenie projektu

Pierwszym krokiem definiowania zadania migracji jest utworzenie zasobu projektu. Po utworzeniu projektu możesz dodać źródłowe i docelowe punkty końcowe dla źródła danych. W tym przykładzie celowo pozostawisz pole opisu puste. Następnie dodasz go w sekcji Wyświetl i zmodyfikujesz właściwości projektu w dalszej części tego artykułu.

Ważne

Jeśli zasób nie został jeszcze wdrożony przy użyciu dostawcy zasobów, musisz utworzyć zasób najwyższego poziomu.

Ostrzeżenie

Zmiana nazwy zasobów projektu nie jest obsługiwana. Dobrym pomysłem jest upewnienie się, że projekt został nazwany odpowiednio, ponieważ nie będzie można zmienić nazwy projektu po jego aprowizacji.

Portal Azure

1. Przejdź do strony Projekty w portalu Azure, aby uzyskać dostęp do projektów. Domyślny widok Wszystkie projekty zawiera nazwy wszystkich zaaprowizowanych projektów i podsumowanie zadań, które zawierają.

   

2. Wybierz pozycję Utwórz projekt , aby otworzyć okienko Tworzenie projektu . Podaj wartość nazwy projektu w polu Nazwa projektu , ale pozostaw puste pole Opis projektu . Zaktualizujesz właściwości projektu w późniejszym kroku. Na koniec wybierz pozycję Utwórz , aby aprowizować projekt.

   

PowerShell

Utworzenie projektu wymaga podjęcia decyzji o nazwie. Zapoznaj się z konwencją nazewnictwa zasobów, aby wybrać obsługiwaną nazwę. Opis jest opcjonalny i może zawierać maksymalnie 1024 znaki jedno bajtów.

Polecenie New-AzStorageMoverProject cmdlet służy do tworzenia nowego projektu w ramach wcześniej wdrożonego zasobu Storage Mover. Jeśli jeszcze nie zainstalowałeś modułu 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

Więcej szczegółów znajduje się w artykule Instalowanie programu Azure PowerShell .

Musisz podać wartości dla wymaganych -Nameparametrów , -ResourceGroupNamei -StorageMoverName . Parametr -Description jest opcjonalny.

1. Zawsze dobrym pomysłem jest utworzenie zmiennych i użycie ich do przechowywania długich lub potencjalnie złożonych ciągów.

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

2. Połącz się z kontem Azure przy użyciu cmdlet Connect-AzAccount. Określ identyfikator subskrypcji, podając wartość parametru -Subscription , jak pokazano w przykładzie.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. Po pomyślnym nawiązaniu połączenia możesz użyć New-AzStorageMoverProject polecenia cmdlet , aby utworzyć nowy projekt, jak pokazano w poniższym przykładzie.

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

   Następująca przykładowa odpowiedź zawiera ProvisioningState właściwość, której wartość wskazuje, że projekt został pomyślnie utworzony.

   
   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
   
   

Wyświetlanie i edytowanie właściwości projektu

W zależności od przypadku użycia może być konieczne pobranie określonego projektu lub pełnej listy wszystkich zasobów projektu. Może być również konieczne dodanie lub edytowanie opisu projektu.

Wykonaj kroki opisane w tej sekcji, aby wyświetlić projekty dostępne dla zasobu usługi Storage Mover.

Portal Azure

1. Przejdź do strony Projekty w portalu Azure, aby wyświetlić listę dostępnych projektów. Możesz tworzyć i stosować filtry, aby ograniczyć lub kształtować widok. Aby zawęzić zakres wyników, możesz nadal dodawać więcej filtrów.

   

   Filtry mogą być również edytowane lub usuwane zgodnie z potrzebami, jak pokazano w poniższym przykładzie. Obecnie obsługiwane jest tylko filtrowanie projektów według nazwy.

   

2. W okienku Projekty lub na liście wyników wybierz nazwę projektu utworzonego w poprzedniej sekcji. Właściwości i dane podsumowania zadania projektu są wyświetlane w okienku szczegółów .

   Jeśli projekt nie ma prawidłowego opisu, wybierz pozycję Dodaj opis , aby wyświetlić okienko Edytuj opis .

   

   Jeśli opis istnieje, zostanie wyświetlony poniżej nagłówka Opis . Wybierz ikonę Edytuj obok opisu lub ikonę Edytuj opis , aby wyświetlić okienko edycji. Na poniższej ilustracji przedstawiono lokalizację dwóch ikon.

   

3. W okienku edycji zmodyfikuj opis projektu. W dolnej części okienka wybierz pozycję Zapisz , aby zatwierdzić zmiany.

   

PowerShell

1. Użyj polecenia cmdlet Get-AzStorageMoverProject, aby pobrać listę zasobów projektów. Opcjonalnie możesz podać wartość parametru -Name , aby pobrać określony zasób projektu. Wywołanie polecenia cmdlet bez opcjonalnego parametru zwraca listę wszystkich zaaprowizowanych projektów w grupie zasobów.

   Poniższy przykład pobiera określony zasób projektu, określając wartość demoProject .

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

   Poniższa przykładowa odpowiedź zawiera właściwości określonego projektu, w tym puste Description.

   
      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. Aby dodać brakujący opis do projektu zwróconego przez cmdlet, należy użyć polecenia Update-AzStorageMoverProject cmdlet. Jednak w tym przypadku parametry -ResourceGroupName, -StorageMoverName i -Name są wszystkie wymagane. Należy również podać brakującą wartość opisu projektu z parametrem -Description, jak pokazano w poniższym przykładzie.

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

   Element ProvisioningState uwzględniony w odpowiedzi potwierdza, że projekt został pomyślnie zaktualizowany.

   
     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
   
   

Usuwanie projektu

Usunięcie zasobu projektu powinno być stosunkowo rzadkim wystąpieniem w środowisku produkcyjnym, ale mogą wystąpić sytuacje, w których może to być przydatne. Aby usunąć zasób projektu Storage Mover, postępuj zgodnie z podanym przykładem.

Ostrzeżenie

Usuwanie projektu jest trwałą akcją i nie można jej cofnąć. Dobrym pomysłem jest przygotowanie do usunięcia projektu, ponieważ nie będzie można go przywrócić w późniejszym czasie.

Portal Azure

1. Przejdź do strony Projekty w portalu Azure, aby wyświetlić projekty i podsumowanie zadań, które zawierają.

   

2. Najpierw w okienku Projekty lub na liście wyników wybierz nazwę projektu, który chcesz usunąć. Następnie wybierz pozycję Usuń projekt z okienka Szczegóły projektu .

   

   Na koniec w oknie dialogowym Potwierdzanie usuwania projektu wybierz pozycję Usuń , aby trwale usunąć projekt. W razie potrzeby zapoznaj się z wyróżnionymi opcjami na poniższej ilustracji.

   

Ostrzeżenie

Usunięcie projektu spowoduje usunięcie wszystkich skojarzonych definicji zadań, w tym ich historii uruchamiania i wyników. Usunięcie któregokolwiek z tych zasobów jest trwałe i nie można go cofnąć. Nie ma to wpływu na punkty końcowe magazynu.

PowerShell

Użyj elementu , Remove-AzStorageMoverProject aby trwale usunąć zasób projektu. Podaj nazwę projektu za pomocą parametru -Name, a nazwy zasobu grupy zasobów i zasobu magazynu mover odpowiednio za pomocą parametrów -ResourceGroupName i -StorageMoverName.

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

Ostrzeżenie

Usunięcie projektu spowoduje usunięcie wszystkich skojarzonych definicji zadań, w tym ich historii uruchamiania i wyników. Usunięcie któregokolwiek z tych zasobów jest trwałe i nie można go cofnąć. Nie ma to wpływu na punkty końcowe magazynu.

Dalsze kroki

Po utworzeniu projektów możesz rozpocząć pracę z definicjami zadań.

Definiowanie zadania migracji