Tutorial: Usar APIs REST para copiar dados para o armazenamento de Blob do Azure Data Box

Atenção

Este artigo faz referência ao CentOS, uma distribuição Linux com status de Fim de Vida (EOL). Por favor, considere o seu uso e planejamento de acordo. Para obter mais informações, consulte as diretrizes de Fim da Vida Útil do CentOS.

Este tutorial descreve os procedimentos para se conectar ao armazenamento de Blob do Azure Data Box por meio de APIs REST sobre http ou https. Uma vez conectado, as etapas necessárias para copiar os dados para o armazenamento de Blob do Data Box e preparar o Data Box para envio também são descritas.

Neste tutorial, irá aprender a:

• Pré-requisitos
• Conectar-se ao armazenamento de Blob do Data Box via http ou https
• Copiar dados para o Data Box

Pré-requisitos

Antes de começar, certifique-se de que:

1. Conclua o Tutorial: Configurar o Azure Data Box.
2. Recebe a sua Data Box e o estado da encomenda no portal é Entregue.
3. Você revisa os requisitos do sistema para armazenamento de Blob Data Box e está familiarizado com as versões suportadas de APIs, SDKs e ferramentas.
4. Você tem acesso a um computador host que tem os dados que você deseja copiar para o Data Box. O seu computador anfitrião deve:
   • Executar um sistema operativo suportado.
   • Estar ligado a uma rede de alta velocidade. Recomendamos vivamente que tenha, pelo menos, uma ligação de 10 GbE. Você pode usar um link de dados de 1 GbE se uma conexão de 10 GbE não estiver disponível, embora as velocidades de cópia sejam afetadas.
5. Faça o download do AzCopy V10 no seu computador host. O AzCopy é usado para copiar dados para o armazenamento de Blob do Azure Data Box do seu computador host.

Conecte-se via http ou https

Você pode se conectar ao armazenamento de Blob do Data Box por http ou https.

• Https é a maneira segura e recomendada de se conectar ao armazenamento de Blob do Data Box.
• Http é usado ao se conectar através de redes confiáveis.

As etapas para se conectar são diferentes quando você se conecta ao armazenamento de Blob do Data Box por http ou https.

Conecte-se via http

A conexão com APIs REST de armazenamento de Blob do Data Box sobre http requer as seguintes etapas:

• Adicionar o IP do dispositivo e o ponto de extremidade do serviço de blob ao host remoto
• Configurar software de parceiro e verificar a conexão

Cada uma dessas etapas é descrita nas seções a seguir.

Adicionar endereço IP do dispositivo e ponto de extremidade do serviço de blob

1. Inicie sessão no dispositivo Data Box. Certifique-se de que está desbloqueado.

   

2. Vá para Definir interfaces de rede. Anote o endereço IP do dispositivo para a interface de rede usada para se conectar ao cliente.

   

3. Vá para Conectar, copie e clique em Descansar.

   

4. Na caixa de diálogo Acessar conta de armazenamento e carregar dados , copie o ponto de extremidade do serviço de Blob.

   

5. Inicie o Bloco de Notas como administrador e, em seguida, abra o ficheiro de anfitriões localizado em C:\Windows\System32\Drivers\etc.

6. Adicione a seguinte entrada ao seu arquivo hosts : <device IP address> <Blob service endpoint>

7. Para referência, use a imagem a seguir. Salve o arquivo hosts .

   

Verificar a conexão e configurar o software do parceiro

Configure o software do parceiro para se conectar ao cliente. Para se conectar ao software parceiro, você normalmente precisa das seguintes informações (podem variar) coletadas na página Conectar e copiar da interface do usuário da Web local na etapa anterior:

• Nome da conta de armazenamento
• Chave de acesso
• Ponto final de serviço blob

Para verificar se a conexão foi estabelecida com êxito, use o Gerenciador de Armazenamento para anexar a uma conta de armazenamento externa. Se você não tiver o Gerenciador de Armazenamento, precisará baixar e instalar.

Na primeira vez que usar o Gerenciador de Armazenamento, você precisará executar as seguintes etapas:

1. Na barra de comandos superior, vá para Editar > Stack do Azure de Destino.

   

2. Reinicie o Gerenciador de Armazenamento para que as alterações entrem em vigor.

   

Siga estas etapas para se conectar à conta de armazenamento e verificar a conexão.

1. No Gerenciador de Armazenamento, abra a caixa de diálogo Conectar ao Armazenamento do Azure. Na caixa de diálogo Conectar ao Armazenamento do Azure, selecione Usar um nome e uma chave de conta de armazenamento.

   

2. Cole o nome da conta e a chave da conta (valor da chave 1 da página Conectar e copiar na interface do usuário da Web local). Selecione Domínio de pontos de extremidade de armazenamento como Outro (insira abaixo) e forneça o ponto de extremidade do serviço de blob, conforme mostrado abaixo. Marque a opção Usar HTTP somente se estiver transferindo por http. Se estiver usando https, deixe a opção desmarcada. Selecione Seguinte.

   

3. Na caixa de diálogo Resumo da Conexão , revise as informações fornecidas. Selecione Ligar.

   

4. A conta que você adicionou com êxito é exibida no painel esquerdo do Gerenciador de Armazenamento com (Externo, Outro) anexado ao seu nome. Clique em Contêineres de Blob para exibir o contêiner.

   

Conecte-se via https

A conexão com APIs REST de armazenamento de Blob do Azure sobre https requer as seguintes etapas:

• Baixe o certificado do portal do Azure. Esse certificado é usado para se conectar à interface do usuário da Web e às APIs REST de armazenamento de Blob do Azure.
• Importe o certificado no cliente ou host remoto.
• Adicione o IP do dispositivo e o ponto de extremidade do serviço de blob ao cliente ou host remoto.
• Configure o software do parceiro e verifique a conexão.

Cada uma dessas etapas é descrita nas seções a seguir.

Download do certificado

Use o portal do Azure para baixar o certificado.

1. Inicie sessão no Portal do Azure.

2. Aceda à sua encomenda Data Box e navegue até Detalhes gerais > do dispositivo.

3. Em Credenciais do dispositivo, vá para Acesso à API para o dispositivo. Selecione Transferir. Esta ação faz o download de um <arquivo de certificado .cer nome> do pedido. Salve esse arquivo e instale-o no computador cliente ou host que você usa para se conectar ao dispositivo.

   

Certificado de importação

O acesso ao armazenamento de Blob do Data Box por HTTPS requer um certificado TLS/SSL para o dispositivo. A maneira como esse certificado é disponibilizado para o aplicativo cliente varia de aplicativo para aplicativo e entre sistemas operacionais e distribuições. Alguns aplicativos podem acessar o certificado depois de importá-lo para o armazenamento de certificados do sistema, enquanto outros aplicativos não fazem uso desse mecanismo.

Informações específicas para algumas aplicações são mencionadas nesta seção. Para obter mais informações sobre outros aplicativos, consulte a documentação do aplicativo e do sistema operacional usado.

Siga estas etapas para importar o .cer arquivo para o armazenamento raiz de um cliente Windows ou Linux. Em um sistema Windows, você pode usar o Windows PowerShell ou a interface do usuário do Windows Server para importar e instalar o certificado em seu sistema.

Utilizar o Windows PowerShell

1. Inicie uma sessão do Windows PowerShell como administrador.

2. Na linha de comandos, escreva:

   Import-Certificate -FilePath C:\temp\localuihttps.cer -CertStoreLocation Cert:\LocalMachine\Root
   

Usar a interface do usuário do Windows Server

1. Clique com o botão direito do mouse no .cer arquivo e selecione Instalar certificado. Esta ação inicia o Assistente para Importação de Certificados.

2. Em Local da loja, selecione Máquina local e, em seguida, selecione Avançar.

   

3. Selecione Colocar todos os certificados no armazenamento a seguir e, em seguida, selecione Procurar. Navegue até o armazenamento raiz do host remoto e selecione Avançar.

   

4. Selecione Concluir. É exibida uma mensagem informando que a importação foi bem-sucedida.

   

Usar um sistema Linux

O método para importar um certificado varia de acordo com a distribuição.

Vários, como Ubuntu e Debian, usam o update-ca-certificates comando.

• Renomeie o arquivo de certificado codificado em Base64 para ter uma .crt extensão e copie-o para o /usr/local/share/ca-certificates directory.
• Execute o comando update-ca-certificates.

As versões recentes do RHEL, Fedora e CentOS usam o update-ca-trust comando.

• Copie o arquivo de certificado para o /etc/pki/ca-trust/source/anchors diretório.
• Execute o update-ca-trust.

Consulte a documentação específica da sua distribuição para obter detalhes.

Adicionar endereço IP do dispositivo e ponto de extremidade do serviço de blob

Siga as mesmas etapas para adicionar o endereço IP do dispositivo e o ponto de extremidade do serviço de blob ao se conectar por http.

Configurar software de parceiro e verificar a conexão

Siga as etapas para Configurar o software de parceiro que você usou ao se conectar por http. A única diferença é que você deve deixar a opção Usar http desmarcada.

Copiar dados para o Data Box

Depois que um ou mais compartilhamentos do Data Box estiverem conectados, a próxima etapa é copiar dados. Antes de iniciar operações de cópia de dados, considere as seguintes limitações:

• Ao copiar os dados, certifique-se de que o respetivo tamanho está em conformidade com os limites descritos em Limites de armazenamento do Azure e do Data Box.
• Carregamentos simultâneos pelo Data Box e outro aplicativo que não seja Data Box podem resultar em falhas no trabalho de upload e corrupção de dados.

Importante

Certifique-se de manter uma cópia dos dados de origem até poder confirmar que os dados foram copiados para o Armazenamento do Azure.

Neste tutorial, o AzCopy é usado para copiar dados para o armazenamento de Blob do Data Box. Se preferir uma ferramenta baseada em GUI, você também pode usar o Gerenciador de Armazenamento do Azure ou outro software parceiro para copiar os dados.

O procedimento de cópia tem as seguintes etapas:

• Criar um contentor
• Carregar conteúdo de uma pasta para o armazenamento de Blob do Data Box
• Carregar arquivos modificados para o armazenamento de Blob do Data Box

Cada uma dessas etapas é descrita em detalhes nas seções a seguir.

Criar um contentor

A primeira etapa é criar um contêiner, porque os blobs são sempre carregados em um contêiner. Os contêineres organizam grupos de blobs como você organiza arquivos em pastas no seu computador. Siga estas etapas para criar um contêiner de blob.

1. Abra o Explorador de Armazenamento.

2. No painel esquerdo, expanda a conta de armazenamento na qual você deseja criar o contêiner de blob.

3. Clique com o botão direito do mouse em Contêineres de Blob e, no menu de contexto, selecione Criar Contêiner de Blob.

   

4. Uma caixa de texto aparece abaixo da pasta Contêineres de Blob. Introduza o nome do contentor de blobs. Consulte Criar o contêiner e definir permissões para obter informações sobre regras e restrições para nomear contêineres de blob.

5. Pressione Enter quando terminar para criar o contêiner de blob ou Esc para cancelar. Após a criação bem-sucedida, o contêiner de blob é exibido na pasta Contêineres de Blob da conta de armazenamento selecionada.

   

Carregue o conteúdo de uma pasta para o armazenamento de Blob do Data Box

Use o AzCopy para carregar todos os arquivos dentro de uma pasta para o armazenamento de Blob no Windows ou Linux. Para carregar todos os blobs numa pasta, introduza o seguinte comando do AzCopy:

Linux

azcopy \
    --source /mnt/myfolder \
    --destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
    --dest-key <key> \
    --recursive

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ /DestKey:<key> /S

Substitua <key> pela chave da sua conta. Você pode recuperar sua chave de conta no portal do Azure navegando até sua conta de armazenamento. Selecione Configurações > Teclas de acesso, escolha uma chave e, em seguida, copie e cole o valor no comando AzCopy.

Se o contêiner de destino especificado não existir, o AzCopy o criará e carregará o arquivo nele. Atualize o caminho de origem para o diretório de dados e substitua data-box-storage-account-name na URL de destino pelo nome da conta de armazenamento associada ao Data Box.

Para carregar o conteúdo do diretório especificado para o armazenamento de Blob recursivamente, especifique a --recursive opção para Linux ou a /S opção para Windows. Quando executar o AzCopy com uma destas opções, todas as subpastas e respetivos ficheiros são também carregados.

Carregar arquivos modificados para o armazenamento de Blob do Data Box

Você também pode usar o AzCopy para fazer upload de arquivos com base em seu tempo de última modificação. Para carregar apenas arquivos novos ou atualizados, adicione o --exclude-older parâmetro para Linux ou o parâmetro para Windows /XO ao comando AzCopy.

Se você quiser copiar apenas os recursos dentro de sua fonte local que não existem no destino, especifique os --exclude-older parâmetros e --exclude-newer para Linux ou os /XO parâmetros e /XN para Windows no comando AzCopy. O AzCopy carrega apenas dados atualizados, conforme determinado pelo seu carimbo de data/hora.

Linux

azcopy \
--source /mnt/myfolder \
--destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
--dest-key <key> \
--recursive \
--exclude-older

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ /DestKey:<key> /S /XO

Se houver erros durante a operação de conexão ou cópia, consulte Solucionar problemas com o armazenamento de Blob do Data Box.

O próximo passo é preparar o seu dispositivo para envio.

Próximos passos

Neste tutorial, ficou a conhecer tópicos do Azure Data Box, como:

• Pré-requisitos para copiar dados para o armazenamento de Blob do Azure Data Box usando APIs REST
• Conectando-se ao armazenamento de Blob do Data Box via http ou https
• Copiar dados para o Data Box

Avance para o tutorial seguinte para saber como enviar o Data Box de volta para a Microsoft.

Enviar o Azure Data Box para a Microsoft