Administración de proyectos de Azure Storage Mover

Un proyecto de Storage Mover se usa para organizar los trabajos de migración en tareas o componentes lógicos. Un proyecto contiene al menos una definición de trabajo, que a su vez describe cada origen de datos y punto de conexión de destino para el proyecto. El artículo Descripción de la jerarquía de recursos de Storage Mover contiene información más detallada sobre la relación entre storage Mover y sus proyectos.

Cuando se define un proyecto, se recomienda agregar todos los orígenes de datos relacionados y dependientes en el mismo proyecto para que se puedan migrar juntos. Debe agregar todos los orígenes de datos necesarios para migrar una sola carga de trabajo en lugar de crear proyectos para cada origen de datos del plan de migración. También puede optar por crear proyectos individuales para cada grupo distinto de orígenes de datos en el plan de migración.

Este artículo le guía por la creación y administración de proyectos de Azure Storage Mover. Para seguir estos ejemplos, necesitará un recurso de transferencia de almacenamiento de alto nivel. Si aún no ha creado uno, siga los pasos descritos en el artículo Creación de un recurso de Storage Mover antes de continuar.

Después de completar los pasos de este artículo, podrá crear y administrar proyectos mediante Azure Portal y Azure PowerShell.

Creación de un proyecto

El primer paso para definir un trabajo de migración es la creación de un recurso de proyecto. Una vez creado el proyecto, puede agregar puntos de conexión de origen y de destino para el origen de datos. En este ejemplo, dejará intencionadamente en blanco el campo de descripción . A continuación, lo agregará en la sección Ver y editar las propiedades de un proyecto más adelante en este artículo.

Importante

Si aún no ha implementado un recurso mediante el proveedor de recursos, deberá crear el recurso de nivel superior.

Precaución

No se admite el cambio de nombre de los recursos del proyecto. Es una buena idea asegurarse de que ha nombrado el proyecto correctamente, ya que no podrá cambiar el nombre del proyecto después de provisionado.

Azure Portal

1. Vaya a la página Explorador de proyectos de Azure Portal para acceder a los proyectos. La vista Todos los proyectos predeterminados muestra los nombres de los proyectos aprovisionados y un resumen de los trabajos que contienen.

   

2. Seleccione Crear proyecto para abrir el panel Crear un proyecto . Proporcione un valor de nombre de proyecto en el campo Nombre del proyecto, pero deje vacío el campo Descripción del proyecto. Por último, seleccione Crear para aprovisionar el proyecto.

   

PowerShell

La creación de un proyecto requiere que decida un nombre. Consulte la convención de nomenclatura de recursos para elegir un nombre admitido. Una descripción es opcional y puede contener hasta 1024 caracteres de un solo byte.

El cmdlet se utiliza para crear un nuevo proyecto dentro de un recurso de movimiento de almacenamiento que ya desplegó anteriormente. Si aún no ha instalado el Az.StorageMover módulo:

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

El artículo Instalación de Azure PowerShell tiene más detalles.

Deberá proporcionar valores para los parámetros necesarios -Name, -ResourceGroupName y -StorageMoverName. El -Description parámetro es opcional.

1. Siempre es una buena idea crear y usar variables para almacenar cadenas largas o potencialmente complejas.

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

2. Conéctese a su cuenta de Azure mediante el Connect-AzAccount cmdlet . Especifique el identificador de la suscripción proporcionando un valor para el -Subscription parámetro como se muestra en el ejemplo.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. Después de haberse conectado correctamente, puede usar el New-AzStorageMoverProject cmdlet para crear su nuevo proyecto, como se muestra en el ejemplo siguiente.

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

   La siguiente respuesta de ejemplo contiene la ProvisioningState propiedad cuyo valor indica que el proyecto se creó correctamente.

   
   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
   
   

Ver y editar las propiedades de un proyecto

Según el caso de uso, es posible que tenga que recuperar un proyecto específico o una lista completa de todos los recursos del proyecto. También es posible que tenga que agregar o editar la descripción de un proyecto.

Siga los pasos de esta sección para ver los proyectos accesibles para el recurso de Storage Mover.

Azure Portal

1. Vaya a la página Explorador de proyectos de la Azure Portal para ver una lista de proyectos disponibles. Puede crear y aplicar filtros para limitar o dar forma a la vista. Para restringir el ámbito de los resultados, puede seguir agregando más filtros.

   

   Los filtros también se pueden editar o quitar según sea necesario, como se muestra en el ejemplo siguiente. Actualmente, solo se admite el filtrado de proyectos por nombre.

   

2. En el panel del explorador de proyectos o en la lista de resultados, seleccione el nombre del proyecto creado en la sección anterior. Las propiedades del proyecto y los datos de resumen de trabajos se muestran en el panel de detalles.

   Si el proyecto no tiene una descripción válida, seleccione Agregar descripción para mostrar el panel Editar descripción .

   

   Si existe una descripción, se mostrará debajo del encabezado Descripción . Seleccione el icono Editar situado junto a la descripción o el icono Editar descripción para mostrar el panel de edición. En la imagen siguiente se muestra la ubicación de los dos iconos.

   

3. En el panel de edición, modifique la descripción del proyecto. En la parte inferior del panel, seleccione Guardar para confirmar los cambios.

   

PowerShell

1. Use el Get-AzStorageMoverProject cmdlet para recuperar una lista de recursos de proyectos. Opcionalmente, puede proporcionar un -Name valor de parámetro para recuperar un recurso de proyecto específico. Al llamar al cmdlet sin el parámetro opcional, se devuelve una lista de todos los proyectos aprovisionados dentro del grupo de recursos.

   En el ejemplo siguiente se recupera un recurso de proyecto específico especificando el valor demoProject .

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

   La respuesta de ejemplo a continuación contiene las propiedades especificadas del proyecto, incluyendo el vacío 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. Para agregar la descripción que falta al proyecto devuelto por el cmdlet, deberá usar el Update-AzStorageMoverProject cmdlet . Sin embargo, en este caso, los parámetros -ResourceGroupName, -StorageMoverName y -Name son todos necesarios. También querrá proporcionar el valor que falta de la descripción del proyecto con el parámetro -Description, tal como se muestra en el ejemplo siguiente.

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

   El ProvisioningState elemento incluido en la respuesta confirma que el proyecto se actualizó correctamente.

   
     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
   
   

Eliminación de un proyecto

La eliminación de un recurso de proyecto debe ser una aparición relativamente poco frecuente en el entorno de producción, aunque puede haber ocasiones en las que pueda resultar útil. Para eliminar un recurso de proyecto de Storage Mover, siga el ejemplo proporcionado.

Advertencia

La eliminación de un proyecto es una acción permanente y no se puede deshacer. Es una buena idea asegurarse de que está preparado para eliminar el proyecto, ya que no podrá restaurarlo más adelante.

Azure Portal

1. Vaya a la página Explorador de proyectos de Azure Portal para ver los proyectos y un resumen de los trabajos que contienen.

   

2. En primer lugar, en el panel Explorador de proyectos o en la lista de resultados, seleccione el nombre del proyecto que desea eliminar. A continuación, seleccione Eliminar proyecto en el panel Detalles del proyecto . Por último, en el cuadro de diálogo Confirmar eliminación del proyecto , seleccione Eliminar para quitar permanentemente el proyecto. Consulte las selecciones resaltadas en la siguiente imagen si es necesario.

   

Advertencia

Al eliminar un proyecto, se eliminarán todas las definiciones de trabajo contenidas, su historial de ejecución y los resultados. La eliminación de cualquiera de estos recursos es permanente y no se puede deshacer. Los puntos de conexión de almacenamiento no se ven afectados.

PowerShell

Usa Remove-AzStorageMoverProject para eliminar permanentemente un recurso de proyecto. Proporcione el nombre del proyecto con el parámetro -Name, y los nombres del grupo de recursos y del recurso mover de almacenamiento con los parámetros -ResourceGroupName y -StorageMoverName, respectivamente.

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

Advertencia

Al eliminar un proyecto, se eliminarán todas las definiciones de trabajo contenidas, su historial de ejecución y los resultados. La eliminación de cualquiera de estos recursos es permanente y no se puede deshacer. Los puntos de conexión de almacenamiento no se ven afectados.

Pasos siguientes

Una vez creados los proyectos, puede empezar a trabajar con definiciones de trabajo.

Definición de un trabajo de migración