Tutorial: Copiar dados para o Armazenamento de Blobs do Azure Data Box por meio de APIs REST

  • Artigo

Cuidado

Este artigo faz referência ao CentOS, uma distribuição do Linux que está se aproximando do status de EOL (fim da vida útil). Considere seu uso e planejamento adequadamente. Para obter mais informações, confira as diretrizes sobre o fim da vida útil do CentOS.

Este tutorial descreve os procedimentos usados para se conectar ao Armazenamento de Blobs do Azure Data Box por meio de APIs REST via HTTP ou HTTPS. Após a conexão, as etapas necessárias para copiar os dados para o Armazenamento de Blobs do Data Box são descritas.

Neste tutorial, você aprenderá como:

  • Pré-requisitos
  • Conectar-se ao Armazenamento de Blobs do Data Box via HTTP ou HTTPS
  • Copiar dados para o Data Box Heavy

Pré-requisitos

Antes de começar, verifique se:

  1. Você concluiu o Tutorial: Configurar o Azure Data Box Heavy.
  2. Você recebeu o Data Box Heavy e o status do pedido no portal está como Entregue.
  3. Você examinou os requisitos do sistema para o Armazenamento de Blobs do Data Box e está familiarizado com as versões compatíveis de APIs, SDKs e ferramentas.
  4. Você tem acesso a um computador host contendo os dados que deseja copiar para o Data Box Heavy. O computador host deve
    • Executar um Sistema operacional com suporte.
    • Estar conectado a uma rede de alta velocidade. Para velocidades de cópia mais rápidas, duas conexões de 40 GbE (uma por nó) podem ser utilizadas em paralelo. Se você não tem uma conexão de 40 GbE disponível, recomendamos que você tenha pelo menos duas conexões de 10 GbE (uma por nó).
  5. Baixe o AzCopy 7.1.0 no computador host. Você usará o AzCopy para copiar dados para o Armazenamento de Blobs do Azure Data Box do computador host.

Conectar-se via HTTP ou HTTPS

Conecte-se ao Armazenamento de Blobs do Data Box via HTTP ou HTTPS.

  • HTTPS é a maneira segura e recomendada de se conectar ao Armazenamento de Blobs do Data Box.
  • O HTTP é usado para a conexão em redes confiáveis.

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

Conectar-se via HTTP

A conexão às APIs REST do Armazenamento de Blobs do Data Box via HTTP exige as seguintes etapas:

  • Adicionar o IP do dispositivo e o ponto de extremidade de serviço 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 o endereço IP do dispositivo e o ponto de extremidade de serviço Blob

  1. Entre no dispositivo Data Box. Verifique se ele está desbloqueado.

    A captura de tela mostra o painel com o dispositivo exibido como Desbloqueado.

  2. Acesse Definir adaptadores de rede. Anote o endereço IP do dispositivo para o adaptador de rede usado para se conectar ao cliente.

    A captura de tela mostra a opção Configurações de Rede, na qual você pode ver o endereço IP.

  3. Vá para Conectar e copiar e clique em Rest.

    A captura de tela mostra o painel Conectar e copiar, no qual pode selecionar a REST como uma configuração de acesso.

  4. Na caixa de diálogo Acessar a conta de armazenamento e carregar dados, copie o Ponto de Extremidade de Serviço Blob.

    A captura de tela mostra a caixa de diálogo Acessar conta de armazenamento e carregar dados, em que você pode copiar o Ponto de Extremidade de Serviço Blob.

  5. Inicie o Bloco de notas como administrador e, em seguida, abra o arquivo hosts localizado em C:\Windows\System32\Drivers\etc.

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

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

    A captura de tela mostra um documento do Bloco de notas com o endereço IP e o ponto de extremidade de serviço blob adicionados.

Configurar o software parceiro e verificar a conexão

Configure o software parceiro para se conectar ao cliente. Para se conectar ao software do parceiro, normalmente são necessárias as seguintes informações (que podem variar), obtidas na página Conectar e copiar da IU da Web local na etapa anterior:

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

Para verificar se a conexão foi estabelecida com êxito, use o Gerenciador de Armazenamento para se anexar a uma conta de armazenamento externo. 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, acesse Editar > Definir Azure Stack como Destino.

    A captura de tela mostra a opção Definir Azure Stack como Destino selecionada no menu Editar.

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

    A captura de tela mostra o botão Reiniciar Agora.

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-se ao Armazenamento do Azure. Na caixa de diálogo Conectar-se ao Armazenamento do Azure, selecione Usar um nome e uma chave da conta de armazenamento.

    A captura de tela mostra a caixa de diálogo Conectar-se ao Armazenamento do Azure com a opção Usar um nome e uma chave da conta de armazenamento selecionada.

  2. Cole o Nome da conta e a Chave de conta (valor da chave 1 da página Conectar e copiar na interface do usuário da Web local). Selecione o domínio dos pontos de extremidade do Armazenamento como Outros (inserir abaixo) e, em seguida, forneça o ponto de extremidade de serviço Blob, conforme mostrado abaixo. Marque a opção Usar HTTP somente se a transferência for feita via HTTP. Se estiver usando HTTPS, deixe a opção desmarcada. Selecione Avançar.

    A captura de tela mostra a caixa de diálogo Conectar ao Nome e à Chave com os valores inseridos.

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

    A captura de tela mostra a caixa de diálogo Resumo da Conexão com a opção Conectar selecionada.

  4. A conta adicionada com êxito é exibida no painel esquerdo do Gerenciador de Armazenamento com (Externa, Outros) acrescentado ao nome. Clique em Contêineres de Blobs para exibir o contêiner.

    A captura de tela mostra o menu do Gerenciador com a opção Contêineres de Blobs selecionada.

Conectar-se via HTTPS

A conexão às APIs REST do Armazenamento de Blobs do Azure via HTTPS exige as seguintes etapas:

  • Baixar o certificado no portal do Azure
  • Importar o certificado no host remoto ou do cliente
  • Adicionar o IP do dispositivo e o ponto de extremidade de serviço Blob ao host remoto ou do cliente
  • 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ó.

Baixar certificado

Use o portal do Azure para baixar o certificado.

  1. Entre no portal do Azure.

  2. Acesse sua ordem do Data Box e navegue para Geral > Detalhes do dispositivo.

  3. Em Credenciais do dispositivo, acesse Acesso à API no dispositivo. Clique em Download. Essa ação baixa um arquivo de certificado <nome de seu pedido>.cer. Salve esse arquivo. Você instalará esse certificado no computador cliente ou host que será usado para se conectar ao dispositivo.

    Baixar o certificado no portal do Azure

Importar certificado

O acesso ao armazenamento de blobs do Data Box via HTTPS requer um certificado TLS/SSL para o dispositivo. A maneira na qual esse certificado é disponibilizado para o aplicativo cliente varia de acordo com o aplicativo e entre sistemas operacionais e distribuições. Alguns aplicativos podem acessar o certificado depois que ele é importado no repositório de certificados do sistema, enquanto outros aplicativos não fazem uso desse mecanismo.

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

Siga estas etapas para importar o arquivo .cer para o repositório 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 no sistema.

Usar o Windows PowerShell

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

  2. No prompt de comando, digite:

    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 arquivo .cer e selecione Instalar certificado. Essa ação inicia o Assistente para Importação de Certificados.

  2. Em Localização do repositório, selecione Computador Local e, em seguida, clique em Próximo.

    Importar o certificado usando o PowerShell

  3. Selecione Colocar todos os certificados no seguinte repositório e, em seguida, clique em Procurar. Navegue até o repositório de raiz do seu host remoto e, em seguida, clique em Próximo.

    Importar o certificado usando o PowerShell 2

  4. Clique em Concluir. Será exibida uma mensagem que informa que a importação foi bem-sucedida.

    Importar o certificado usando o PowerShell 3

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árias delas, tais como Ubuntu e Debian, usam o comando update-ca-certificates.

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

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

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

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

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

Siga as mesmas etapas para adicionar endereço IP do dispositivo e ponto de extremidade de serviço Blob ao se conectar via HTTP.

Configurar o software parceiro e verificar a conexão

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

Copiar dados para o Data Box Heavy

Depois que você estiver conectado ao Armazenamento de Blobs do Data Box, a próxima etapa será copiar dados. Antes da cópia de dados, examine as seguintes considerações:

  • Durante a cópia de dados, verifique se o tamanho dos dados está em conformidade com os limites de tamanho descritos nos Limites do Armazenamento do Azure e do Data Box Heavy.
  • Se os dados carregados pelo Data Box Heavy estiverem sendo carregados simultaneamente por outros aplicativos fora do Data Box Heavy, isso poderá causar dados corrompidos e falhas no trabalho de upload.

Neste tutorial, o AzCopy é usado para copiar dados para o Armazenamento de Blobs do Data Box. Use também 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 contêiner
  • Carregar o conteúdo de uma pasta no Armazenamento de Blobs do Data Box
  • Carregar os arquivos modificados no Armazenamento de Blobs do Data Box

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

Importante

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

Criar um contêiner

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

  1. Abra o Explorer do Armazenamento.

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

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

    Menu de contexto Criar contêineres de blob

  4. Uma caixa de texto será exibida abaixo da pasta Contêineres de Blobs. Insira o nome de seu contêiner de blobs. Confira Criar o contêiner e definir as permissões para obter informações sobre regras e restrições de nomenclatura de contêineres de blobs.

  5. Pressione Enter quanto terminar de criar o contêiner de blobs ou Esc para cancelar. Após a criação bem-sucedida do contêiner de blobs, ele será exibido na pasta Contêineres de Blobs da conta de armazenamento selecionada.

    Contêiner de blobs criado

Carregar o conteúdo de uma pasta no Armazenamento de Blobs do Data Box

Use o AzCopy para carregar todos os arquivos de uma pasta no Armazenamento de Blobs no Windows ou no Linux. Para carregar todos os blobs em uma pasta, digite 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 conta. Para obter a chave da conta, no portal do Azure, acesse sua conta de armazenamento. Acesse Configurações > Chaves de acesso, selecione uma chave e cole-a no comando do 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 recursivamente do Armazenamento de Blobs, especifique a opção --recursive (Linux) ou /S (Windows). Quando você executa o AzCopy com uma dessas opções, todas as subpastas e os respectivos arquivos são carregados também.

Carregar os arquivos modificados no Armazenamento de Blobs do Data Box

Use o AzCopy para carregar arquivos com base na hora de sua última modificação. Para testar isso, modifique ou crie novos arquivos em seu diretório de origem para fins de teste. Para carregar apenas arquivos novos ou atualizados, adicione o parâmetro --exclude-older (Linux) ou /XO (Windows) ao comando AzCopy.

Se você quiser copiar apenas os recursos de origem que não existem no destino, especifique ambos os parâmetros, --exclude-older e --exclude-newer (Linux), ou /XO e /XN (Windows), no comando AzCopy. O AzCopy carrega apenas os dados atualizados, com base em seu 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 conectar ou copiar, consulte Solucionar problemas com o armazenamento de blobs do Data Box.

A próxima etapa é preparar seu dispositivo para envio.

Próximas etapas

Neste tutorial, você aprendeu sobre tópicos do Azure Data Box como:

  • Pré-requisitos
  • Conectar-se ao Armazenamento de Blobs do Data Box via HTTP ou HTTPS
  • Copiar dados para o Data Box Heavy

Avance para o próximo tutorial para saber como enviar o Data Box novamente à Microsoft.

Enviar o Azure Data Box Heavy para a Microsoft