Configuración de transferencias con Microsoft Azure Blob Storage

Cómo descargar y preparar su agente

1. Abra la consola de AWS DataSync en https://console.aws.amazon.com/datasync/.

2. En el panel de navegación situado a la izquierda, elija Agentes y luego, Crear agente.

3. Para Hipervisor, elija Microsoft Hyper-V y, a continuación, elija Descargar la imagen.

   El agente se descarga en un archivo .zip que contiene un archivo .vhdx.

4. Extraiga el archivo .vhdx en su máquina local.

5. Abra PowerShell y haga lo siguiente:

   1. Copie el siguiente cmdlet de Convert-VHD:

      Convert-VHD -Path .\local-path-to-vhdx-file\aws-datasync-2.0.1686143940.1-x86_64.xfs.gpt.vhdx `
      -DestinationPath .\local-path-to-vhdx-file\aws-datasync-2016861439401-x86_64.vhd -VHDType Fixed

   2. Sustituya cada instancia de local-path-to-vhdx-file por la ubicación del archivo .vhdx en su máquina local.

   3. Ejecute el comando.

   Su agente ahora es un VHD de tamaño fijo (con un formato de archivo .vhd) y está listo para su implementación en Azure.

Cómo implementar su agente en Azure

1. En PowerShell, vaya al directorio que contiene el archivo .vhd de su agente.

2. Ejecute el comando ls y guarde el valor Length (por ejemplo, 85899346432).

   Este es el tamaño de la imagen del agente en bytes, que necesitará al crear un disco administrado que pueda contener la imagen.

3. Haga lo siguiente para crear un disco administrado:

   1. Copie el siguiente comando Azure de la CLI:

      az disk create -n your-managed-disk `
      -g your-resource-group `
      -l your-azure-region `
      --upload-type Upload `
      --upload-size-bytes agent-size-bytes `
      --sku standard_lrs

   2. Sustituya your-managed-disk por un nombre para su disco administrado.

   3. Sustituya your-resource-group por el nombre del grupo de recursos de Azure al que pertenece su cuenta de almacenamiento.

   4. Sustituya your-azure-region por la región de Azure en la que se encuentra su grupo de recursos.

   5. Sustituya agent-size-bytes por el tamaño de su imagen de agente.

   6. Ejecute el comando.

   Este comando crea un disco administrado vacío con un SKU estándar donde puede cargar su agente de DataSync.

4. Para generar una firma de acceso compartido (SAS) que permita el acceso de escritura al disco administrado, haga lo siguiente:

   1. Copie el siguiente comando Azure de la CLI:

      az disk grant-access -n your-managed-disk `
      -g your-resource-group `
      --access-level Write `
      --duration-in-seconds 86400

   2. Sustituya your-managed-disk por el nombre del disco administrado que creó.

   3. Sustituya your-resource-group por el nombre del grupo de recursos de Azure al que pertenece su cuenta de almacenamiento.

   4. Ejecute el comando.

      En la salida, busque y anote el URI del SAS. Necesitará este URI cuando cargue el agente en Azure.

   El SAS le permite escribir en el disco durante un máximo de una hora. Esto significa que dispone de una hora para cargar su agente en el disco administrado.

5. Para cargar el agente en su disco administrado en Azure, haga lo siguiente:

   1. Copie el siguiente comando AzCopy:

      .\azcopy copy local-path-to-vhd-file sas-uri --blob-type PageBlob

   2. Sustituya local-path-to-vhd-file por la ubicación del archivo del agente .vhd en su máquina local.

   3. Sustituya sas-uri por el URI de SAS que obtuvo cuando ejecutó el comando az disk grant-access.

   4. Ejecute el comando.

6. Cuando finalice la carga del agente, revoque el acceso al disco administrado. Para hacerlo, copie el siguiente comando Azure de la CLI:

   az disk revoke-access -n your-managed-disk -g your-resource-group

   1. Sustituya your-resource-group por el nombre del grupo de recursos de Azure al que pertenece su cuenta de almacenamiento.

   2. Sustituya your-managed-disk por el nombre del disco administrado que creó.

   3. Ejecute el comando.

7. Haga lo siguiente para conectar el disco administrado a una nueva máquina virtual Linux:

   1. Copie el siguiente comando Azure de la CLI:

      az vm create --resource-group your-resource-group `
      --location eastus `
      --name your-agent-vm `
      --size Standard_E4as_v4 `
      --os-type linux `
      --attach-os-disk your-managed-disk

   2. Sustituya your-resource-group por el nombre del grupo de recursos de Azure al que pertenece su cuenta de almacenamiento.

   3. Sustituya your-agent-vm por un nombre para la máquina virtual que pueda recordar.

   4. Sustituya your-managed-disk por el nombre del disco administrado que está conectando a la máquina virtual.

   5. Ejecute el comando.

Cómo obtener la clave de activación de su agente

1. En el portal de Azure, habilite el diagnóstico de arranque de la máquina virtual para su agente; para ello, seleccione la configuración Habilitar con una cuenta de almacenamiento personalizada y especifique su cuenta de almacenamiento de Azure.

   Una vez que haya activado los diagnósticos de arranque de la máquina virtual de su agente, podrá acceder a la consola local del agente para obtener la clave de activación.

2. Mientras está en el portal de Azure, vaya a su máquina virtual y elija Consola serie.

3. En la consola local del agente, inicie sesión con las siguientes credenciales predeterminadas:

   • Nombre de usuario – admin

   • Contraseña – password

   Recomendamos cambiar al menos la contraseña del agente en algún momento. En la consola local del agente, introduzca 5 en el menú principal y, a continuación, utilice el comando passwd para cambiar la contraseña.

4. Introduzca 0 para obtener la clave de activación del agente.

5. Introduzca la Región de AWS donde está utilizando DataSync (por ejemplo, us-east-1).

6. Elija el punto de conexión del servicio que el agente utilizará para conectar con AWS.

7. Guarde el valor del resultado de la Activation key.

Cómo activar el agente

1. Abra la consola de AWS DataSync en https://console.aws.amazon.com/datasync/.

2. En el panel de navegación situado a la izquierda, elija Agentes y luego, Crear agente.

3. Como Hipervisor, elija Microsoft Hyper-V.

4. Como Tipo de punto de conexión, elija el mismo tipo de punto de conexión de servicio que especificó al obtener la clave de activación de su agente (por ejemplo, elija Puntos de conexión de servicio público en Nombre de la región).

5. Configure su red para que funcione con el tipo de punto de conexión de servicio que utilice su agente. Para conocer los requisitos de la red de punto de conexión del servicio, consulte los siguientes temas:

   • Puntos de conexión de VPC

   • Puntos de conexión públicos

   • Puntos de conexión del estándar federal de procesamiento de información (FIPS

6. Para la clave de activación, haga lo siguiente:

   1. Elija Introducir manualmente la clave de activación de su agente.

   2. Introduzca la clave de activación que obtuvo de la consola local del agente.

7. Elija Crear agente.

Cómo crear un agente de Amazon EC2

1. Implemente un agente de Amazon EC.

2. Elija un punto de conexión de servicio que el agente use para comunicarse con AWS.

   En esta situación, se recomienda utilizar un punto de conexión de servicio de nube privada virtual (VPC).

3. Configure su red para que funcione con los puntos de conexión del servicio de VPC.

4. Active el agente.

1. Abra la consola de AWS DataSync en https://console.aws.amazon.com/datasync/.

2. En el panel de navegación situado a la izquierda, expanda Transferencia de datos y, a continuación, seleccione Ubicaciones y Crear ubicación.

3. En Tipo de ubicación, elija Microsoft Azure Blob Storage.

4. En URL del contenedor, escriba la URL del contenedor implicado en la transferencia.

5. (Opcional) Para Acceder al nivel de acceso cuando se usa como destino, elija el nivel de acceso al que quiere que se transfieran sus objetos o archivos.

6. En Carpeta, introduzca los segmentos de ruta si desea limitar la transferencia a un directorio virtual del contenedor (por ejemplo,/my/images).

7. Si la transferencia requiere un agente, seleccione Usar agentes y, a continuación, seleccione el agente de DataSync que se pueda conectar al contenedor de Azure Blob Storage.

8. En el token SAS, proporcione las credenciales necesarias para que DataSync acceda al almacenamiento Blob. Algunos conjuntos de datos públicos en Azure Blob Storage no requieren credenciales. Puede introducir un token SAS directamente o especificar un secreto AWS Secrets Manager que contenga el token. Para obtener más información, consulte Cómo proporcionar credenciales para ubicaciones de almacenamiento.

   El token SAS forma parte de la cadena del URI de SAS que aparece después del URI del recurso de almacenamiento y de un signo de interrogación (?). Un token tiene un aspecto similar a este:

   sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D

9. (Opcional) Proporcione valores para los campos Clave y Valor para etiquetar la ubicación.

   Las etiquetas le ayudan a administrar, filtrar y buscar sus recursos de AWS. Le recomendamos crear al menos una etiqueta de nombre para su ubicación.

10. Seleccione Crear ubicación.

1. Copie el siguiente comando create-location-azure-blob:

   aws datasync create-location-azure-blob \
     --container-url "https://path/to/container" \
     --authentication-type "SAS" \
     --sas-configuration '{
         "Token": "your-sas-token"
       }' \
     --agent-arns my-datasync-agent-arn \
     --subdirectory "/path/to/my/data" \
     --access-tier "access-tier-for-destination" \
     --tags [{"Key": "key1","Value": "value1"}]

2. Para el parámetro --container-url, especifique la URL del contenedor Azure Blob Storage implicado en la transferencia.

3. En el parámetro --authentication-type, especifique SAS. Si se accede a un conjunto de datos público que no requiere autenticación, especifique NONE.

4. Para la opción --sas-configuration del parámetro Token, especifique el token SAS que permite a DataSync acceder a su almacenamiento de blobs.

   También puede proporcionar parámetros adicionales para proteger las claves mediante AWS Secrets Manager. Para obtener más información, consulte Cómo proporcionar credenciales para ubicaciones de almacenamiento.

   El token SAS forma parte de la cadena del URI de SAS que aparece después del URI del recurso de almacenamiento y de un signo de interrogación (?). Un token tiene un aspecto similar a este:

   sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D

5. (Opcional) En el parámetro --agent-arns, especifique el nombre de recurso de Amazon (ARN) del agente de DataSync que se puede conectar al contenedor.

   El siguiente es un ejemplo de agente de ARN: arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890aaabfb

   Puede especificar más de un agente. Para obtener más información, consulte Uso de varios DataSync agentes.

6. Para el parámetro --subdirectory, especifique los segmentos de ruta si quiere limitar la transferencia a un directorio virtual del contenedor (por ejemplo, /my/images).

7. (Opcional) Para el parámetro --access-tier, especifique el nivel de acceso (HOT, COOL o ARCHIVE) al que quiere que se transfieran sus objetos o archivos.

   Este parámetro solo es aplicable cuando se utiliza esta ubicación como destino de transferencia.

8. (Opcional) Para el parámetro --tags, especifique pares clave-valor que le ayuden a administrar, filtrar y buscar su ubicación.

   Le recomendamos crear una etiqueta de nombre para su ubicación.

9. Ejecute el comando create-location-azure-blob.

   Si el comando se ejecuta correctamente, recibirá una respuesta que le mostrará el ARN de la ubicación que creó. Por ejemplo:

   { 
       "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh" 
   }

1. Abra la consola de AWS DataSync en https://console.aws.amazon.com/datasync/.

2. En el panel de navegación situado a la izquierda, expanda Transferencia de datos y, a continuación, seleccione Ubicaciones.

3. Elija su ubicación de Azure Blob Storage.

   Puede ver detalles sobre su ubicación, incluidas las tareas de transferencia de DataSync que la estén utilizando.

1. Copie el siguiente comando describe-location-azure-blob:

   aws datasync describe-location-azure-blob \
     --location-arn "your-azure-blob-location-arn"

2. Para el parámetro --location-arn, especifique el ARN de la ubicación Azure Blob Storage que creó (por ejemplo, arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh).

3. Ejecute el comando describe-location-azure-blob.

   Recibirá una respuesta que le mostrará detalles sobre su ubicación. Por ejemplo:

   {
       "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh",
       "LocationUri": "azure-blob://my-user.blob.core.windows.net/container-1",
       "AuthenticationType": "SAS",
       "Subdirectory": "/my/images",
       "AgentArns": ["arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890deadfb"],
   }

1. Copie el siguiente comando update-location-azure-blob:

   aws datasync update-location-azure-blob \
     --location-arn "your-azure-blob-location-arn" \
     --authentication-type "SAS" \
     --sas-configuration '{
         "Token": "your-sas-token"
       }' \
     --agent-arns my-datasync-agent-arn \
     --subdirectory "/path/to/my/data" \
     --access-tier "access-tier-for-destination"

2. Para el parámetro --location-arn, especifique el ARN de la ubicación Azure Blob Storage que va a actualizar (por ejemplo, arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh).

3. En el parámetro --authentication-type, especifique SAS.

4. Para la opción --sas-configuration del parámetro Token, especifique el token SAS que permite a DataSync acceder a su almacenamiento de blobs.

   El token forma parte de la cadena URI de SAS que aparece después del URI del recurso de almacenamiento y de un signo de interrogación (?). Un token tiene un aspecto similar a este:

   sp=r&st=2022-12-20T14:54:52Z&se=2022-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=qCBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D

5. En el parámetro --agent-arns, especifique el nombre de recurso de Amazon (ARN) del agente de DataSync que desea conectar a su contenedor.

   El siguiente es un ejemplo de agente de ARN: arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890aaabfb

   Puede especificar más de un agente. Para obtener más información, consulte Uso de varios DataSync agentes.

6. Para el parámetro --subdirectory, especifique los segmentos de ruta si quiere limitar la transferencia a un directorio virtual del contenedor (por ejemplo, /my/images).

7. (Opcional) Para el parámetro --access-tier, especifique el nivel de acceso (HOT, COOL o ARCHIVE) al que desea que se transfieran sus objetos.

   Este parámetro solo es aplicable cuando se utiliza esta ubicación como destino de transferencia.