Tutorial: Copiar dados para o armazenamento de Blob do Azure Data Box por meio de APIs REST

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

Pré-requisitos

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

1. Você concluiu o Tutorial: Configurar o Azure Data Box Heavy.
2. Recebeu o Data Box Heavy e o estado da encomenda no portal é Entregue.
3. Você analisou os requisitos do sistema para o armazenamento de Blob do 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 deseja copiar para o Data Box Heavy. O seu computador anfitrião deve
   • Executar um sistema operativo suportado.
   • Estar ligado a uma rede de alta velocidade. Para velocidades de cópia mais rápidas, podem ser utilizadas em paralelo duas ligações de 40 GbE (uma por nó). Se não tiver uma ligação de 40 GbE disponível, recomendamos que tenha pelo menos duas ligações de 10 GbE (uma por nó).
5. Faça o download do AzCopy 7.1.0 no seu computador host. Você usará o AzCopy 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 terceiros e verificar a conexão

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

Importante

Para o Data Box Heavy, você precisará repetir todas as instruções de conexão para se conectar ao segundo nó.

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 .

   

Configurar software de parceiro e verificar a conexão

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
• Importar o certificado no cliente ou host remoto
• Adicionar o IP do dispositivo e o ponto de extremidade do serviço de blob ao cliente ou host remoto
• Configurar software de terceiros e verificar a conexão

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

Importante

Para o Data Box Heavy, você precisará repetir todas as instruções de conexão para se conectar ao segundo nó.

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. Clique em Transferir. Esta ação faz o download de um <arquivo de certificado .cer nome> do pedido. Salve este arquivo. Você instalará esse certificado no computador cliente ou host que usará 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 que ele é importado 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 clique em Avançar.

   

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

   

4. Clique em 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.

Importante

Para o Data Box Heavy, você precisará repetir todas as instruções de conexão para se conectar ao segundo nó.

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 Heavy

Depois de se conectar ao armazenamento de Blob do Data Box, a próxima etapa é copiar os dados. Antes da cópia dos dados, analise as seguintes considerações:

• Ao copiar dados, verifique se o tamanho dos dados está em conformidade com os limites de tamanho descritos nos limites de armazenamento do Azure e Data Box Heavy.
• Se os dados, que estão sendo carregados pelo Data Box Heavy, forem carregados simultaneamente por outros aplicativos fora do Data Box Heavy, isso pode resultar em falhas de trabalho de upload e corrupção de dados.

Neste tutorial, o AzCopy é usado para copiar dados para o armazenamento de Blob do Data Box. Você também pode usar o Gerenciador de Armazenamento do Azure (se preferir uma ferramenta baseada em GUI) ou um 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.

Importante

Para o Data Box Heavy, você precisará repetir todas as instruções de cópia para copiar dados para o segundo nó.

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. Depois que o contêiner de blob é criado com êxito, ele é exibido na pasta Contêineres de Blob para a conta de armazenamento selecionada.

   

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

Use o AzCopy para carregar todos os arquivos em 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/files/ \
    --dest-key <key> \
    --recursive

Windows

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

Substitua <key> pela chave da sua conta. Para obter a sua chave de conta, no portal do Azure, aceda à sua conta de armazenamento. Vá para Configurações > Teclas de acesso, selecione uma chave e cole-a no comando AzCopy.

Se o contentor de destino especificado não existir, o AzCopy cria-o e carrega o ficheiro para o mesmo. 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 Blobs recursivamente, especifique a opção --recursive (Linux) ou /S (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

Use o AzCopy para carregar arquivos com base no tempo da última modificação. Para experimentar, modifique ou crie novos ficheiros no diretório de origem para fins de teste. Para carregar apenas ficheiros novos ou atualizados, adicione o parâmetro --exclude-older (Linux) ou /XO (Windows) ao comando do AzCopy.

Se quiser copiar apenas recursos de origem que não existem no destino, especifique os parâmetros --exclude-older e --exclude-newer (Linux) ou /XO e /XN (Windows) no comando do AzCopy. O AzCopy carrega apenas os dados atualizados, com base no respetivo carimbo de data/hora.

Linux

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

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-heavy-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /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
• Conectar-se ao armazenamento de Blob do Data Box via http ou https
• Copiar dados para o Data Box Heavy

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

Enviar o Azure Data Box Heavy para a Microsoft