Gerenciar projetos do Migrador de Armazenamento do Azure
Artigo
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.
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.
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.
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
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
Depois de se conectar com sucesso, use o cmdlet New-AzStorageMoverProject para criar seu projeto, conforme mostrado no exemplo a seguir.
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.
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.
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.
No painel de edição, modifique a descrição do projeto. Na parte inferior do painel, selecione Salvar para confirmar as alterações.
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.
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
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.
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.
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.
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.
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.
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.
