Como definir e iniciar um trabalho de migração

Ao migrar um compartilhamento para o Azure, você precisa descrever o compartilhamento de origem, o destino do Azure e todas as configurações de migração que deseja aplicar. Esses atributos são definidos em uma definição de trabalho dentro do recurso do Migrador de Armazenamento. Este artigo descreve como criar e executar essa definição de trabalho.

Pré-requisitos

Antes de começar a seguir os exemplos deste artigo, é importante que você tenha uma compreensão da hierarquia de recursos do Migrador de Armazenamento do Azure. Examine o artigo Noções básicas sobre a hierarquia de recursos do Migrador de Armazenamento para entender a necessidade dos pré-requisitos de definição de trabalho.

Há três pré-requisitos para a definição da migração dos seus compartilhamentos de origem:

• Um recurso de movimentação de armazenamento existente.
  Se você não tiver implantado um recurso de movimentador de armazenamento, siga as etapas no artigo Criar um recurso de movimentador de armazenamento. Essas etapas ajudam você a implantar um recurso de movimentação de armazenamento na região desejada em sua assinatura do Azure.
• Pelo menos uma máquina virtual (VM) existente do agente do Azure Storage Mover.
  As etapas nos artigos de implantação de VM e registro de agente do agente do Azure Storage Mover orientam você pelo processo de implantação e registro.
• Finalmente, você precisa criar uma definição de trabalho para definir uma migração.
  As definições de trabalho são organizadas em um projeto de migração. Você precisa de pelo menos um projeto de migração em seu recurso de movimentação de armazenamento. Se você ainda não tiver feito isso, siga as etapas de implantação no artigo gerenciar projetos para criar um projeto de migração.

Criar e iniciar uma definição de trabalho

Uma definição de trabalho é criada em um recurso de projeto. A criação de uma definição de trabalho exige que você selecione ou configure um projeto, um ponto de extremidade de armazenamento de origem e de destino e um nome do trabalho. Se você seguiu os exemplos contidos nos artigos anteriores, talvez tenha um projeto existente em um recurso de movimentador de armazenamento implantado anteriormente. Siga as etapas nesta seção para adicionar uma definição de trabalho a um projeto.

Os pontos de extremidade de armazenamento são recursos separados no migrador de armazenamento. Você precisa criar um ponto de extremidade de origem e de destino antes de poder fazer referência a eles em uma definição de trabalho. Os exemplos nesta seção descrevem o processo de criação de pontos de extremidade.

Consulte o artigo da convenção de nomenclatura de recursos para obter ajuda com a escolha de nomes de recursos com suporte.

Azure portal

1. Navegue até a página Gerenciador de Projetos no portal do Azure para ver a lista de projetos disponíveis. Se nenhum projeto existir ou for necessário criar um novo projeto, siga as etapas incluídas no artigo Gerenciar projetos do Migrador de Armazenamento do Azure.

   

   No painel Gerenciador de Projetos ou na lista de resultados, selecione o nome de um projeto disponível. As propriedades do projeto e os dados de resumo do trabalho são exibidos no painel de detalhes. Quaisquer definições de trabalho existentes e trabalhos implantados definidos para o projeto também são mostrados.

   No menu de ações no painel de detalhes do projeto, selecione Criar definição de trabalho para abrir a janela Criar um trabalho de migração. Se não houver definições de trabalho no projeto, você também poderá selecionar Criar uma definição de trabalho na parte inferior do painel, conforme mostrado no exemplo a seguir.

   

2. Na guia Noções básicas da janela Criar um trabalho de migração, insira um valor no campo obrigatório Nome. Você também pode adicionar um valor de descrição opcional de menos de 1024 caracteres. Por fim, na seção Agente de migração, selecione o agente para executar a migração de dados e selecione Avançar para abrir a guia Fonte. Você deve escolher um agente localizado o mais próximo possível da fonte de dados. O agente selecionado também deve ter recursos apropriados para o tamanho e a complexidade do trabalho. É possível atribuir um agente diferente ao trabalho posteriormente, caso queira.

   

3. Na guia Origem, selecione uma opção no campo Ponto de extremidade de origem. Você pode optar por usar um ponto de extremidade de origem existente ou criar um novo recurso de ponto de extremidade.

   Se você quiser usar um ponto de extremidade de origem existente que tenha definido anteriormente, escolha a opção Selecionar um ponto de extremidade existente. Em seguida, selecione o link Selecionar um ponto de extremidade existente como origem para abrir o painel de ponto de extremidade de origem. Este painel exibe uma lista detalhada dos pontos de extremidade definidos anteriormente. Selecione o ponto de extremidade apropriado e escolha Selecionar para retornar à guia Origem e popular o campo Ponto de extremidade de origem existente.

   

   Para definir um novo ponto de extremidade de origem do qual migrar seus dados, selecione a opção Criar um novo ponto de extremidade . Em seguida, forneça valores para os campos obrigatórios Nome de host ou IP, Nome do compartilhamento e Versão do protocolo. Você também pode adicionar um valor de descrição opcional de menos de 1024 caracteres.

   

   Somente certos tipos de pontos de extremidade podem ser usados como origem ou destino, respectivamente. As etapas para criar diferentes tipos de ponto de extremidade são semelhantes, assim como seus campos de dados correspondentes. O principal diferencial entre a criação de pontos de extremidade habilitados para NFS e SMB é o uso do Cofre de Chaves do Azure para armazenar a credencial compartilhada para recursos SMB. Ao criar um recurso de ponto de extremidade que ofereça suporte ao protocolo SMB, é necessário fornecer valores para o nome do Cofre de Chaves e também os nomes dos segredos de nome de usuário e senha.

   Selecione o nome do Cofre de Chaves nas listas suspensas Cofre de Chaves . Você pode fornecer valores para o Segredo para nome de usuário e Segredo para senha selecionando o segredo relevante na lista suspensa correspondente. Como alternativa, você pode fornecer o URI para o segredo, conforme mostrado na captura de tela a seguir.

   Para obter mais informações sobre recursos de endpoint, consulte o artigo Gerenciando pontos de extremidade do Storage Mover.

   

   Por padrão, os trabalhos de migração começam a partir da raiz do compartilhamento. No entanto, se o caso de uso envolver a cópia de dados de um caminho específico no compartilhamento de origem, você poderá fornecer o caminho no campo Subcaminho. O fornecimento desse valor inicia a migração de dados do local especificado. Se o subcaminho especificado não for encontrado, nenhum dado será copiado.

   Antes de criar um ponto de extremidade e um recurso de trabalho, é importante verificar se o caminho que você especificou está correto e se os dados estão acessíveis. Não é possível modificar pontos de extremidade ou recursos de trabalho depois que eles são criados. Se o caminho especificado estiver errado, sua única opção é excluir os recursos e recriá-los.

   Os valores do host, do nome do compartilhamento e do subcaminho são concatenados para formar o caminho de origem de migração completo. O caminho é exibido no campo Caminho completo na seção Verificar caminho completo. Copie o caminho fornecido e verifique se você pode acessá-lo antes de confirmar suas alterações.

   Após confirmar que o compartilhamento está acessível, selecione Avançar para salvar as configurações do ponto de extremidade de origem e começar a definir o destino.

4. Na guia Destino, selecione uma opção para o campo Ponto de extremidade de destino.

   Da mesma forma que com o ponto de extremidade de origem, escolha a opção Selecionar uma referência de ponto de extremidade existente se você quiser usar um ponto de extremidade definido anteriormente. Em seguida, selecione o link Selecionar um ponto de extremidade existente como destino para abrir o painel de ponto de extremidade de destino. Uma lista detalhada dos pontos de extremidade definidos anteriormente será exibida. Na lista de pontos de extremidade, selecione o ponto de extremidade desejado e, em seguida, selecione para preencher o campo Ponto de extremidade de origem existente e retorne à guia Origem.

   

   Similarmente, para definir um novo ponto de extremidade de destino, escolha a opção Criar um novo ponto de extremidade. Em seguida, selecione valores nas listas suspensas para os campos obrigatórios Conta de assinatura e armazenamento. Você também pode adicionar um valor de descrição opcional de menos de 1024 caracteres. Dependendo do seu caso de uso, selecione o tipo *Target apropriado.

   Lembre-se de que certos tipos de pontos de extremidade só podem ser usados como origem ou destino, respectivamente.

   A versão atual do Mover de Armazenamento do Azure oferece suporte a migrações de fidelidade total para combinações específicas de pares origem-destino. Sempre utilize a versão mais recente do agente para se beneficiar dessas origens e destinos suportados:

   Protocolo de origem	Destino	Comentários
   Montagem SMB 2.x	Compartilhamento de arquivos do Azure (SMB)	As origens SMB 1.x e os compartilhamentos de arquivos do Azure NFS não têm suporte no momento.
   Montagem NFS 3 & 4	Contêiner do armazenamento de blobs do Azure	Há suporte para contêineres com o recurso "Serviço de Namespace Hierárquico (HNS)" habilitado e o conjunto de APIs REST do ADLS Gen2 é usado para migração.

   

   Um valor de subcaminho de destino pode ser usado para especificar um local dentro do contêiner de destino onde os dados migrados serão copiados. O valor do subcaminho é relativo à raiz do contêiner. Você pode fornecer um valor exclusivo para gerar uma nova subpasta. Se você omitir o valor do subcaminho, os dados serão copiados para a raiz.

   Após verificar a precisão das configurações, selecione Avançar para continuar.

5. Na guia Configurações, anote as configurações associadas ao Modo de cópia e aos Resultados de migração. O modo de cópia do serviço afeta o comportamento do mecanismo de migração quando arquivos ou pastas são alterados entre iterações de cópia.

   Mesclar origem em destino:

   • Os arquivos estão no destino, mesmo que não existam na origem.
   • Os arquivos com nomes e caminhos correspondentes são atualizados para corresponder à origem.
   • Renomeações de arquivo ou pasta entre cópias criam conteúdo duplicado no destino.

   Espelhar a origem para o destino:

   • Os arquivos no destino serão excluídos se não existirem na origem.
   • Os arquivos e pastas no destino são atualizados para corresponder à origem.
   • Renomeações de arquivos ou pastas entre cópias não geram conteúdo duplicado. Um item renomeado no lado de origem leva à exclusão do item com o nome original no destino. Além disso, o item renomeado também é carregado no destino. Se o item renomeado for uma pasta, o comportamento descrito de excluir e recarregar se aplicará a todos os arquivos e pastas contidos nele. Evite renomear pastas durante uma migração, especialmente perto do nível raiz dos dados de origem.

   Os resultados da migração são baseados nos tipos de armazenamento específicos dos pontos de extremidade de origem e de destino. Por exemplo, como o armazenamento de blob oferece suporte apenas a pastas "virtuais", os arquivos de origem em pastas têm seus caminhos anexados a seus nomes e colocados em uma lista simples dentro de um contêiner de blob. As pastas vazias são representadas como um blob vazio no destino. Os metadados da pasta de origem são mantidos no campo de metadados personalizados de um blob, como acontece com os arquivos.

   Depois de exibir os efeitos do modo de cópia e dos resultados de migração, selecione Avançar para examinar os valores das guias anteriores.

6. Examine as configurações de nome e descrição do trabalho e as configurações do ponto de extremidade de armazenamento de origem e destino. Use as opções Anterior e Avançar para navegar pelas guias e corrigir quaisquer erros, se necessário. Por fim, selecione Criar para provisionar a definição de trabalho.

   

PowerShell

Você precisa usar vários cmdlets para criar uma nova definição de trabalho. Como mencionado anteriormente, os pontos de extremidade de origem e destino devem ser criados antes de serem referenciados por uma definição de trabalho.

Use o cmdlet New-AzStorageMoverJobDefinition para criar um recurso de definição de trabalho em um projeto. Os exemplos a seguir pressupõem que você não está reutilizando pontos de extremidade de armazenamento criados anteriormente.

      
##  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

Próximas etapas

Agora que você criou uma definição de trabalho com pontos de extremidade de origem e destino, saiba como estimar o tempo necessário para executar o trabalho de migração.

Metas de desempenho e escala do Migrador de Armazenamento do Azure