Gerenciar projetos do Migrador de Armazenamento do Azure

Um projeto do Migrador de Armazenamento é usado para organizar trabalhos de migração em tarefas lógicas ou componentes. Um projeto contém, pelo menos, uma definição de trabalho, que, por sua vez, descreve cada fonte de dados e ponto de extremidade de destino para seu projeto. O artigo Noções básicas sobre a hierarquia de recursos do Migrador de Armazenamento contém informações mais detalhadas sobre a relação entre um Migrador de Armazenamento e os respectivos projetos.

Quando você define um projeto, é uma boa ideia adicionar todas as fontes de dados relacionadas e interdependentes ao mesmo projeto para que elas possam ser migradas juntas. Você deve adicionar todas as fontes de dados necessárias para migrar uma só carga de trabalho em vez de criar projetos para cada fonte de dados no plano de migração. Você também pode optar por criar projetos individuais para cada grupo distinto de fontes de dados no plano de migração.

Este artigo descreve a criação e o gerenciamento de projetos do Migrador de Armazenamento do Azure. Para seguir estes exemplos, você precisará ter um recurso de migração de armazenamento de nível superior. Caso ainda não tenha criado um, siga as etapas descritas no artigo Criar um recurso do Migrador de Armazenamento antes de continuar.

Depois de concluir as etapas deste artigo, você poderá criar e gerenciar projetos usando o portal do Azure e o Azure PowerShell.

Criar um projeto

A primeira etapa na definição de um trabalho de migração é a criação de um recurso de projeto. Depois que o projeto for criado, você poderá adicionar pontos de extremidade de origem e de destino à fonte de dados. Neste exemplo, você deixará intencionalmente o campo de descrição em branco. Em seguida, você o adicionará na seção Exibir e editar as propriedades de um projeto mais adiante neste artigo.

Importante

Se você ainda não implantou um recurso usando o provedor de recursos, crie o recurso de nível superior.

Cuidado

Não há suporte para renomear os recursos do projeto. É uma boa ideia verificar se você nomeou o projeto adequadamente, pois não poderá alterar o nome do projeto depois que ele for provisionado.

Azure portal

1. Navegue até a página Gerenciador de Projetos no portal do Azure para acessar seus projetos. A exibição padrão Todos os projetos exibe os nomes dos projetos provisionados e um resumo dos trabalhos que eles contêm.

   

2. Selecione Criar projeto para abrir o painel Criar um Projeto. Forneça um valor de nome de projeto no campo Nome do projeto, mas mantenha o campo Descrição do projeto vazio. Por fim, selecione Criar para provisionar o projeto.

   

PowerShell

A criação de um projeto exige que você escolha um nome. Veja a convenção de nomenclatura de recursos para escolher um nome compatível. Uma descrição é opcional e pode conter até 1.024 caracteres de byte único.

O cmdlet New-AzStorageMoverProject é usado para criar um projeto em um recurso de migração de armazenamento já implantado. Caso você ainda não tenha instalado o módulo 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

O artigo Instalar o Azure PowerShell traz mais detalhes.

Você precisará fornecer valores para os parâmetros obrigatórios -Name, -ResourceGroupName e -StorageMoverName. O -Description é opcional.

1. É sempre uma boa ideia criar e usar variáveis para armazenar cadeias de caracteres longas ou potencialmente complexas.

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

2. Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount. Especifique a ID da sua assinatura fornecendo um valor para o parâmetro -Subscription, conforme mostrado no exemplo.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. Depois de se conectar com sucesso, use o cmdlet New-AzStorageMoverProject para criar seu projeto, conforme mostrado no exemplo a seguir.

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

   O exemplo de resposta a seguir contém a propriedade ProvisioningState cujo valor indica que o projeto foi criado com sucesso.

   
   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
   
   

Exibir e editar as propriedades de um projeto

Dependendo do caso de uso, talvez seja necessário recuperar um projeto específico ou uma lista completa de todos os recursos do projeto. Talvez você também precise adicionar ou editar a descrição de um projeto.

Siga as etapas desta seção para ver os projetos acessíveis ao recurso do Migrador de Armazenamento.

Azure portal

1. Navegue até a página Gerenciador de Projetos no portal do Azure para ver a lista de projetos disponíveis. Você pode criar e aplicar filtros para limitar ou formatar a exibição. Para restringir o escopo dos resultados, você pode continuar adicionando mais filtros.

   

   Os filtros também podem ser editados ou removidos quando necessário, conforme mostrado no exemplo abaixo. Atualmente, só há suporte para filtragem de projetos por nome.

   

2. No painel Gerenciador de Projetos ou na lista de resultados, selecione o nome do projeto criado na seção anterior. As propriedades do projeto e os dados de resumo do trabalho são exibidos no painel de detalhes.

   Se o projeto não tiver uma descrição válida, selecione Adicionar descrição para exibir o painel Editar descrição.

   

   Se houver uma descrição, ela será exibida abaixo do título Descrição. Selecione o ícone Editar ao lado da descrição ou o ícone Editar descrição para exibir o painel de edição. A imagem abaixo mostra o local dos dois ícones.

   

3. No painel de edição, modifique a descrição do projeto. Na parte inferior do painel, selecione Salvar para confirmar as alterações.

   

PowerShell

1. Use o cmdlet Get-AzStorageMoverProject para recuperar uma lista de recursos de projetos. Opcionalmente, você pode fornecer um valor de parâmetro -Name para recuperar um recurso de projeto específico. A chamada ao cmdlet sem o parâmetro opcional retorna uma lista de todos os projetos provisionados no grupo de recursos.

   O exemplo a seguir recupera um recurso de projeto específico especificando o valor demoProject.

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

   O exemplo de resposta abaixo contém as propriedades do projeto especificado, incluindo a Description vazia.

   
      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. Para adicionar a descrição ausente ao projeto retornado pelo cmdlet, use o cmdlet Update-AzStorageMoverProject. No entanto, nesta instância, os parâmetros -ResourceGroupName, -StorageMoverName e -Name são obrigatórios. O ideal também será fornecer o valor ausente de Descrição do projeto com o parâmetro -Description, conforme mostrado no exemplo a seguir.

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

   O ProvisioningState incluído na resposta confirma que o projeto foi atualizado com sucesso.

   
     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
   
   

Excluir um projeto

A remoção de um recurso de projeto deve ser uma ocorrência relativamente rara no ambiente de produção, embora possa haver ocasiões em que ela possa ser útil. Para excluir um recurso de projeto do Migrador de Armazenamento, siga o exemplo fornecido.

Aviso

A exclusão de um projeto é uma ação permanente e não pode ser desfeita. É uma boa ideia verificar se você está preparado para excluir o projeto, pois não poderá restaurá-lo posteriormente.

Azure portal

1. Navegue até a página Gerenciador de Projetos no portal do Azure para ver seus projetos e um resumo dos trabalhos que eles contêm.

   

2. Primeiro, no painel Gerenciador de projetos ou na lista de resultados, selecione o nome do projeto que deseja excluir. Em seguida, selecione Excluir projeto no painel Detalhes do projeto. Por fim, na caixa de diálogo Confirmar exclusão do projeto, selecione Excluir para remover o projeto permanentemente. Veja as seleções realçadas na imagem a seguir, se necessário.

   

Aviso

A exclusão de um projeto excluirá todas as definições de trabalho contidas, bem como o histórico de execução e os resultados delas. A exclusão de um desses recursos é permanente e não pode ser desfeita. Os pontos de extremidade de armazenamento não são afetados.

PowerShell

Use o Remove-AzStorageMoverProject para excluir um recurso de projeto permanentemente. Forneça o nome do projeto com o parâmetro -Name e os nomes do grupo de recursos e do recurso de migração de armazenamento com os parâmetros -ResourceGroupName e -StorageMoverName, respectivamente.

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

Aviso

A exclusão de um projeto excluirá todas as definições de trabalho contidas, bem como o histórico de execução e os resultados delas. A exclusão de um desses recursos é permanente e não pode ser desfeita. Os pontos de extremidade de armazenamento não são afetados.

Próximas etapas

Depois que os projetos forem criados, você poderá começar a usar as definições de trabalho.

Definir um trabalho de migração