Configurazione dei trasferimenti con Microsoft Azure Blob Storage

Per scaricare e preparare l'agente

1. Apri la AWS DataSync console all'indirizzo https://console.aws.amazon.com/datasync/.

2. Nel riquadro di navigazione a sinistra, scegli Agenti, quindi scegli Crea agente.

3. Per Hypervisor, scegli Microsoft Hyper-V, quindi scegli Scarica l'immagine.

   L'agente scarica un .zip file che contiene un .vhdx file.

4. Estrai il .vhdx file sul tuo computer locale.

5. Aprire PowerShell e procedere come segue:

   1. Copiare il seguente Convert-VHD cmdlet:

      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. Sostituisci ogni istanza di local-path-to-vhdx-file con la posizione del .vhdx file sul computer locale.

   3. Esegui il comando .

   Il tuo agente è ora un VHD a dimensione fissa (con un formato di .vhd file) pronto per la distribuzione. Azure

Per distribuire il tuo agente in Azure

1. InPowerShell, vai alla directory che contiene il .vhd file del tuo agente.

2. Esegui il ls comando e salva il Length valore (ad esempio,85899346432).

   Questa è la dimensione in byte dell'immagine dell'agente, necessaria per creare un disco gestito in grado di contenere l'immagine.

3. Effettuate le seguenti operazioni per creare un disco gestito:

   1. Copia il seguente Azure comando 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. your-managed-diskSostituiscilo con un nome per il tuo disco gestito.

   3. Sostituiscilo your-resource-group con il nome del gruppo di Azure risorse a cui appartiene l'account di archiviazione.

   4. Sostituiscilo your-azure-region con la Azure regione in cui si trova il tuo gruppo di risorse.

   5. Sostituiscila agent-size-bytes con la dimensione dell'immagine dell'agente.

   6. Esegui il comando .

   Questo comando crea un disco gestito vuoto con uno SKU standard in cui puoi caricare il tuo DataSync agente.

4. Per generare una firma ad accesso condiviso (SAS) che consenta l'accesso in scrittura al disco gestito, procedi come segue:

   1. Copia il seguente Azure comando CLI:

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

   2. Sostituisci your-managed-disk con il nome del disco gestito che hai creato.

   3. Sostituisci your-resource-group con il nome del gruppo di Azure risorse a cui appartiene l'account di archiviazione.

   4. Esegui il comando .

      Nell'output, prendi nota dell'URI SAS. È necessario questo URI quando si carica l'agente suAzure.

   Il SAS consente di scrivere sul disco per un massimo di un'ora. Ciò significa che hai un'ora per caricare il tuo agente sul disco gestito.

5. Per caricare il tuo agente sul tuo disco gestito inAzure, procedi come segue:

   1. Copia il seguente AzCopy comando:

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

   2. Sostituisci local-path-to-vhd-file con la posizione del .vhd file dell'agente sul tuo computer locale.

   3. Sostituisci sas-uri con l'URI SAS che hai ottenuto quando hai eseguito il az disk grant-access comando.

   4. Esegui il comando .

6. Al termine del caricamento dell'agente, revoca l'accesso al disco gestito. Per fare ciò, copia il seguente comando Azure CLI:

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

   1. Sostituiscilo your-resource-group con il nome del gruppo di Azure risorse a cui appartiene l'account di archiviazione.

   2. Sostituisci your-managed-disk con il nome del disco gestito che hai creato.

   3. Esegui il comando .

7. Effettua le seguenti operazioni per collegare il disco gestito a una nuova macchina Linux virtuale:

   1. Copia il seguente Azure comando 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. Sostituiscilo your-resource-group con il nome del gruppo di Azure risorse a cui appartiene l'account di archiviazione.

   3. Sostituiscila your-agent-vm con un nome per la macchina virtuale che ricordi.

   4. Sostituisci your-managed-disk con il nome del disco gestito che stai collegando alla macchina virtuale.

   5. Esegui il comando .

Per ottenere la chiave di attivazione del tuo agente

1. Nel Azure portale, abilita la diagnostica di avvio per la macchina virtuale per il tuo agente scegliendo l'impostazione Abilita con account di archiviazione personalizzato e specificando il tuo Azure account di archiviazione.

   Dopo aver abilitato la diagnostica di avvio per la macchina virtuale dell'agente, puoi accedere alla console locale dell'agente per ottenere la chiave di attivazione.

2. Mentre sei ancora nel Azure portale, vai alla tua macchina virtuale e scegli Console seriale.

3. Nella console locale dell'agente, accedi utilizzando le seguenti credenziali predefinite:

   • Username (Nome utente – admin

   • Password: password

   A un certo punto consigliamo di modificare almeno la password dell'agente. Nella console locale dell'agente, 5 accedi al menu principale, quindi usa il passwd comando per modificare la password.

4. Inserisci 0 per ottenere la chiave di attivazione dell'agente.

5. Inserisci il Regione AWS luogo in cui stai utilizzando DataSync (ad esempio,us-east-1).

6. Scegli l'endpoint del servizio con cui l'agente utilizzerà per connettersi AWS.

7. Salva il valore dell'Activation keyoutput.

Per attivare l'agente

1. Apri la AWS DataSync console all'indirizzo https://console.aws.amazon.com/datasync/.

2. Nel riquadro di navigazione a sinistra, scegli Agenti, quindi scegli Crea agente.

3. Per Hypervisor, scegli. Microsoft Hyper-V

4. Per Tipo di endpoint, scegli lo stesso tipo di endpoint di servizio che hai specificato quando hai ricevuto la chiave di attivazione dell'agente (ad esempio, scegli Endpoint di servizio pubblico in). Region name

5. Configura la rete in modo che funzioni con il tipo di endpoint di servizio utilizzato dall'agente. Per i requisiti di rete degli endpoint di servizio, consulta i seguenti argomenti:

   • Endpoint VPC

   • Endpoint pubblici

   • Endpoint FIPS (Federal Information Processing Standard)

6. Per la chiave di attivazione, procedi come segue:

   1. Scegli Inserisci manualmente la chiave di attivazione del tuo agente.

   2. Inserisci la chiave di attivazione che hai ricevuto dalla console locale dell'agente.

7. Scegliere Create agent (Crea agente).

Per creare un EC2 agente Amazon

1. Implementa un EC2 agente Amazon.

2. Scegli un endpoint di servizio con cui l'agente comunica. AWS

   In questa situazione, consigliamo di utilizzare un endpoint del servizio Virtual Private Cloud (VPC).

3. Configura la tua rete per funzionare con gli endpoint del servizio VPC.

4. Attiva l'agente.

1. Apri la AWS DataSync console all'indirizzo https://console.aws.amazon.com/datasync/.

2. Nel riquadro di navigazione a sinistra, espandi Trasferimento dati, quindi scegli Posizioni e Crea posizione.

3. Per Tipo di posizione, scegliere Microsoft Azure Blob Storage.

4. Per Container URL, inserisci l'URL del contenitore coinvolto nel trasferimento.

5. (Facoltativo) Per il livello di accesso, se utilizzato come destinazione, scegli il livello di accesso in cui desideri trasferire i tuoi oggetti o file.

6. Per Cartella, inserisci i segmenti di percorso se desideri limitare il trasferimento a una directory virtuale del contenitore (ad esempio,/my/images).

7. Se il trasferimento richiede un agente, scegli Usa agenti, quindi scegli l' DataSync agente che può connettersi al tuo Azure Blob Storage contenitore.

8. Per il token SAS, fornisci le credenziali necessarie per accedere DataSync al tuo archivio BLOB. Alcuni set di dati pubblici sull'archiviazione BLOB di Azure non richiedono credenziali. È possibile inserire direttamente un token SAS o specificare un AWS Secrets Manager segreto che contenga il token. Per ulteriori informazioni, vedere Fornitura di credenziali per le posizioni di archiviazione.

   Il token SAS fa parte della stringa URI SAS che segue l'URI della risorsa di archiviazione e un punto interrogativo (?). Un token ha un aspetto simile al seguente:

   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. (Facoltativo) Immettete i valori nei campi Chiave e Valore per etichettare la posizione.

   I tag ti aiutano a gestire, filtrare e cercare AWS le tue risorse. È consigliabile creare almeno un tag di nome per la posizione.

10. Scegli Crea posizione.

1. Copia il seguente create-location-azure-blob comando:

   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. Per il --container-url parametro, specifica l'URL del Azure Blob Storage contenitore coinvolto nel trasferimento.

3. Per il parametro --authentication-type, specifica SAS. Se stai accedendo a un set di dati pubblico che non richiede l'autenticazione, specificaNONE.

4. Per l'Tokenopzione del --sas-configuration parametro, specifica il token SAS che consente di accedere DataSync al tuo archivio BLOB.

   Puoi anche fornire parametri aggiuntivi per proteggere le tue chiavi utilizzando. AWS Secrets Manager Per ulteriori informazioni, vedere Fornitura di credenziali per le posizioni di archiviazione.

   Il token SAS fa parte della stringa URI SAS che segue l'URI della risorsa di archiviazione e un punto interrogativo (?). Un token ha un aspetto simile al seguente:

   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. (Facoltativo) Per il --agent-arns parametro, specifica l'Amazon Resource Name (ARN) dell' DataSync agente che può connettersi al tuo contenitore.

   Ecco un esempio di ARN dell'agente: arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890aaabfb

   È possibile specificare più di un agente. Per ulteriori informazioni, consulta Utilizzo di più agenti DataSync .

6. Per il --subdirectory parametro, specificate i segmenti di percorso se desiderate limitare il trasferimento a una directory virtuale del contenitore (ad esempio,/my/images).

7. (Facoltativo) Per il --access-tier parametro, specificate il livello di accesso (HOTCOOL, oARCHIVE) in cui desiderate trasferire gli oggetti o i file.

   Questo parametro si applica solo quando si utilizza questa posizione come destinazione di trasferimento.

8. (Facoltativo) Per il --tags parametro, specificate le coppie chiave-valore che possono aiutarvi a gestire, filtrare e cercare la vostra posizione.

   È consigliabile creare un tag di nome per la posizione.

9. Esegui il comando create-location-azure-blob.

   Se il comando ha esito positivo, si ottiene una risposta che mostra l'ARN della posizione creata. Per esempio:

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

1. Apri la AWS DataSync console all'indirizzo https://console.aws.amazon.com/datasync/.

2. Nel riquadro di navigazione a sinistra, espandi Trasferimento dati, quindi scegli Posizioni.

3. Scegli la tua Azure Blob Storage posizione.

   Puoi visualizzare i dettagli sulla tua posizione, incluse le attività di DataSync trasferimento che la utilizzano.

1. Copia il seguente describe-location-azure-blob comando:

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

2. Per il --location-arn parametro, specificate l'ARN per la Azure Blob Storage posizione che avete creato (ad esempio,arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh).

3. Esegui il comando describe-location-azure-blob.

   Riceverai una risposta che mostra i dettagli sulla tua posizione. Per esempio:

   {
       "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. Copia il seguente update-location-azure-blob comando:

   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. Per il --location-arn parametro, specifica l'ARN per la Azure Blob Storage posizione che stai aggiornando (ad esempio,arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh).

3. Per il parametro --authentication-type, specifica SAS.

4. Per l'Tokenopzione del --sas-configuration parametro, specifica il token SAS che consente di accedere DataSync al tuo archivio BLOB.

   Il token fa parte della stringa URI SAS che segue l'URI della risorsa di archiviazione e un punto interrogativo (?). Un token ha un aspetto simile al seguente:

   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. Per il --agent-arns parametro, specifica l'Amazon Resource Name (ARN) dell' DataSync agente che desideri connettere al tuo contenitore.

   Ecco un esempio di ARN dell'agente: arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890aaabfb

   È possibile specificare più di un agente. Per ulteriori informazioni, consulta Utilizzo di più agenti DataSync .

6. Per il --subdirectory parametro, specificate i segmenti di percorso se desiderate limitare il trasferimento a una directory virtuale del contenitore (ad esempio,/my/images).

7. (Facoltativo) Per il --access-tier parametro, specificate il livello di accesso (HOTCOOL, oARCHIVE) in cui desiderate trasferire gli oggetti.

   Questo parametro si applica solo quando si utilizza questa posizione come destinazione di trasferimento.