Configurar transferências com o Microsoft Azure Blob Storage

Para baixar e preparar seu atendente

1. Abra o console AWS DataSync do em https://console.aws.amazon.com/datasync/.

2. No painel de navegação à esquerda, escolha Agentes e, em seguida, escolha Criar agente.

3. Para Hypervisor, escolha Microsoft Hyper-V, em seguida, escolha Baixas a imagem.

   O atendente faz o download em um arquivo .zip que contém um arquivo .vhdx.

4. Extraia o arquivo .vhdx na sua máquina local.

5. Abra o PowerShell e faça o seguinte:

   1. Copie o seguinte 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. Substitua cada instância local-path-to-vhdx-file de pela localização do arquivo .vhdx na sua máquina local.

   3. Execute o comando.

   Seu atendente agora é um VHD de tamanho fixo (com formato de arquivo .vhd) e está pronto para ser implantado no Azure.

Para implantar seu atendente no Azure

1. No PowerShell, acesse o diretório que contém o arquivo .vhd do seu atendente.

2. Execute o comando ls e salve o valor Length (por exemplo, 85899346432).

   Esse é o tamanho da imagem do atendente em bytes, necessário ao criar um disco gerenciado que possa conter a imagem.

3. Faça o seguinte para criar um disco gerenciado:

   1. Copie o seguinte comando da CLI Azure:

      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. Substitua your-managed-disk por um nome para seu disco gerenciado.

   3. Substitua your-resource-group pelo nome do grupo de recursos Azure ao qual sua conta de armazenamento pertence.

   4. Substitua your-azure-region pela região Azure em que seu grupo de recursos está localizado.

   5. Substitua agent-size-bytes pelo tamanho da imagem do seu atendente.

   6. Execute o comando .

   Esse comando cria um disco gerenciado vazio com um SKU padrão no qual você pode carregar seu atendente DataSync.

4. Para gerar uma assinatura de acesso compartilhado (SAS) que permita acesso de gravação ao disco gerenciado, faça o seguinte:

   1. Copie o seguinte comando da CLI Azure:

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

   2. Substitua your-managed-disk pelo nome do disco gerenciado que você criou.

   3. Substitua your-resource-group pelo nome do grupo de recursos Azure ao qual sua conta de armazenamento pertence.

   4. Execute o comando .

      Examine o resultado e anote o URI do SAS. Você precisa desse URI ao fazer o upload do atendente para o Azure.

   O SAS permite que você grave no disco por até uma hora. Isso significa que você tem uma hora para carregar seu atendente no disco gerenciado.

5. Para fazer upload do atendente para o disco gerenciado no Azure, faça o seguinte:

   1. Copie o seguinte comando AzCopy:

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

   2. Substitua local-path-to-vhd-file pela localização do arquivo .vhd do atendente em sua máquina local.

   3. Substitua sas-uri pelo URI SAS que você obteve ao executar o comando az disk grant-access.

   4. Execute o comando .

6. Quando o upload do atendente terminar, revogue o acesso ao seu disco gerenciado. Para fazer isso, copie este comando Azure CLI:

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

   1. Substitua your-resource-group pelo nome do grupo de recursos Azure ao qual sua conta de armazenamento pertence.

   2. Substitua your-managed-disk pelo nome do disco gerenciado criado.

   3. Execute o comando.

7. Faça o seguinte para conectar seu disco gerenciado a uma nova VM Linux:

   1. Copie o seguinte comando da CLI Azure:

      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. Substitua your-resource-group pelo nome do grupo de recursos Azure ao qual sua conta de armazenamento pertence.

   3. Substitua your-agent-vm por um nome para a VM que você possa lembrar.

   4. Substitua your-managed-disk pelo nome do disco gerenciado que você está anexando à VM.

   5. Execute o comando .

Para obter a chave de ativação do seu atendente

1. No portal Azure, habilite o diagnóstico de inicialização da VM para seu atendente escolhendo a configuração Habilitar com conta de armazenamento personalizada e especificando sua conta de armazenamento Azure.

   Depois de habilitar o diagnóstico de inicialização para a VM do seu atendente, você pode acessar o console local do atendente para obter a chave de ativação.

2. Enquanto ainda estiver no portal Azure, acesse sua VM e escolha Console serial.

3. No console local do atendente, faça login usando as seguintes credenciais padrão:

   • Nome de usuário – admin

   • Senha – password

   Recomendamos, em algum momento, alterar pelo menos a senha do atendente. No console local do atendente, insira 5 no menu principal e use o comando passwd para alterar a senha.

4. Insira 0 para obter a chave de ativação do atendente.

5. Insira o Região da AWS local em que você está usando o DataSync (por exemplo, us-east-1).

6. Escolha o endpoint de serviço que o atendente usará para se conectar ao AWS.

7. Salve valor da saída Activation key.

Como ativar o agente

1. Abra o console AWS DataSync do em https://console.aws.amazon.com/datasync/.

2. No painel de navegação à esquerda, escolha Agentes e, em seguida, escolha Criar agente.

3. Para Hypervisor, escolha Microsoft Hyper-V.

4. Para Tipo de endpoint, escolha o mesmo tipo de endpoint de serviço que você especificou quando recebeu a chave de ativação do seu atendente (por exemplo, escolha Endpoints de serviço público em Nome da região).

5. Configure sua rede para funcionar com o tipo de endpoint de serviço que seu atendente está usando. Para obter informações sobre os requisitos de rede de endpoints de serviço, consulte os tópicos a seguir:

   • Endpoints do VPC

   • Endpoints públicos

   • Endpoints do Federal Information Processing Standard (FIPS – Padrões Federais de Processamento de Informações

6. Para a Chave de ativação, faça o seguinte:

   1. Escolha Inserir manualmente a chave de ativação do seu agente.

   2. Insira a chave de ativação que você obteve do console local do agente.

7. Escolha Criar agente.

Para criar um atendente do Amazon EC2

1. Implemente um atendente do Amazon EC.

2. Escolha um endpoint de serviço que o atendente use para se comunicar ao AWS.

   Nessa situação, recomendamos o uso de um endpoint de serviço de nuvem privada virtual (VPC).

3. Configure sua rede para funcionar com endpoints de serviço do VPC.

4. Ative o agente.

1. Abra o AWS DataSync console do em https://console.aws.amazon.com/datasync/.

2. No painel de navegação esquerdo, expanda Transferência de dados e escolha Locais e Criar local.

3. Em Tipo de local, escolha Microsoft Azure Blob Storage.

4. Em URL do contêiner, insira o URL do contêiner envolvido na sua transferência.

5. (Opcional) Para Nível de acesso quando usado como destino, escolha o nível de acesso para o qual você deseja que seus objetos ou arquivos sejam transferidos.

6. Em Pasta, insira segmentos de caminho se quiser limitar sua transferência a um diretório virtual em seu contêiner (por exemplo, /my/images).

7. Se a transferência exigir um atendente, escolha Usar atendentes e escolha o atendente do DataSync que pode se conectar ao seu contêiner Azure Blob Storage.

8. Para o token SAS, forneça as credenciais necessárias para que o DataSync acesse o armazenamento de blobs. Alguns conjuntos de dados públicos no armazenamento do Azure Blob não exigem credenciais. Você pode inserir um token SAS diretamente ou especificar um segredo AWS Secrets Manager que contenha o token. Para obter mais informações, consulte Como fornecer credenciais para locais de armazenamento.

   O token SAS faz parte da string SAS URI que vem depois do URI do recurso de armazenamento e de um ponto de interrogação (?). Um token é semelhante ao seguinte:

   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) Forneça valores para os campos Chave e Valor para marcar o local.

   As tags ajudam você a gerenciar, filtrar e pesquisar seus recursos AWS. Recomendamos criar pelo menos uma etiqueta de nome para a sua localização.

10. Escolha Criar local.

1. Copie o seguinte 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 o parâmetro --container-url, especifique o URL do contêiner Azure Blob Storage envolvido na sua transferência.

3. Para o parâmetro --authentication-type, especifique SAS. Se você estiver acessando um conjunto de dados público que não exige autenticação, especifique NONE.

4. Para a opção Token do parâmetro --sas-configuration, especifique o token SAS que permite que o DataSync acesse seu armazenamento de blob.

   Você também pode fornecer parâmetros adicionais para proteger as chaves usando AWS Secrets Manager. Para obter mais informações, consulte Como fornecer credenciais para locais de armazenamento.

   O token SAS faz parte da string SAS URI que vem depois do URI do recurso de armazenamento e de um ponto de interrogação (?). Um token é semelhante ao seguinte:

   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) Em relação ao parâmetro --agent-arns, especifique o nome do recurso da Amazon (ARN) do atendente do DataSync que pode se conectar ao contêiner.

   Aqui está um exemplo de agente ARN: arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890aaabfb

   Você pode especificar mais de um atendente. Para obter mais informações, consulte Usando vários DataSync agentes.

6. Para o parâmetro--subdirectory, especifique segmentos de caminho se quiser limitar sua transferência para um diretório virtual em seu contêiner (por exemplo, /my/images).

7. (Opcional) Para o parâmetro --access-tier, especifique o nível de acesso (HOT, COOL ou ARCHIVE) para a qual você deseja transferir seus objetos ou arquivos.

   Esse parâmetro se aplica somente quando você está usando esse local como destino de transferência.

8. (Opcional) Para o parâmetro --tags, especifique pares chave-valor que ajudam a gerenciar, filtrar e pesquisar sua localização.

   Recomendamos criar uma etiqueta de nome para a sua localização.

9. Execute o comando create-location-azure-blob.

   Se o comando for bem-sucedido, você receberá uma resposta que mostra o ARN do local que você criou. Por exemplo:

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

1. Abra o console do AWS DataSync em https://console.aws.amazon.com/datasync/.

2. No painel de navegação esquerdo, expanda Transferência de dados e, em seguida, escolha Locais.

3. Escolha seu local Azure Blob Storage.

   Você pode ver detalhes sobre sua localização, incluindo qualquer tarefa de transferência do DataSync que a esteja usando.

1. Copie o seguinte comando describe-location-azure-blob:

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

2. Para o parâmetro --location-arn, especifique o ARN do local Azure Blob Storage que você criou (por exemplo, arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh).

3. Execute o comando describe-location-azure-blob.

   Você recebe uma resposta que mostra detalhes sobre sua localização. Por exemplo:

   {
       "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 o seguinte 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 o parâmetro --location-arn, especifique o ARN do local Azure Blob Storage que você está atualizando (por exemplo, arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh).

3. Para o parâmetro --authentication-type, especifique SAS.

4. Para a opção Token do parâmetro --sas-configuration, especifique o token SAS que permite que o DataSync acesse seu armazenamento de blob.

   O token faz parte da string SAS URI que vem depois do URI do recurso de armazenamento e de um ponto de interrogação (?). Um token é semelhante ao seguinte:

   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. Em relação ao parâmetro --agent-arns, especifique o nome do recurso da Amazon (ARN) do atendente do DataSync que deseja conectar ao contêiner.

   Aqui está um exemplo de agente ARN: arn:aws:datasync:us-east-1:123456789012:agent/agent-01234567890aaabfb

   Você pode especificar mais de um atendente. Para obter mais informações, consulte Usando vários DataSync agentes.

6. Para o parâmetro --subdirectory, especifique segmentos de caminho se quiser limitar sua transferência para um diretório virtual em seu contêiner (por exemplo, /my/images).

7. (Opcional) Para o parâmetro --access-tier, especifique o nível de acesso (HOT, COOL ou ARCHIVE) para o qual você deseja que seus objetos sejam transferidos.

   Esse parâmetro se aplica somente quando você está usando esse local como destino de transferência.