Compartir a través de

Tutorial: Copia de datos a Azure Data Box Blob Storage mediante API REST

  • Artículo

Precaución

En este artículo se hace referencia a CentOS, una distribución de Linux con un estado de finalización del servicio (EOL). Tenga en cuenta su uso y planeación en consecuencia. Para más información, consulte la Guía de fin de ciclo de vida de CentOS.

En este tutorial se describen los procedimientos para conectarse a Azure Data Box Blob Storage mediante las API REST con http o https. Una vez conectado, también se describen los pasos necesarios para copiar los datos en Data Box Blob Storage.

En este tutorial, aprenderá a:

  • Prerrequisitos
  • Conexión a Data Box Blob Storage mediante http o https
  • Copia de datos a Data Box Heavy

Requisitos previos

Antes de comenzar, asegúrese de que:

  1. Ha completado el Tutorial: Configuración de Azure Data Box Heavy.
  2. Ha recibido su dispositivo Data Box Heavy y el estado del pedido en el portal se actualiza a Delivered (Entregado).
  3. Ha revisado los requisitos del sistema para Data Box Blob Storage y está familiarizado con las versiones compatibles de las API, los SDK y las herramientas.
  4. Tiene acceso a un equipo host que contiene los datos que desea copiar en su dispositivo Data Box Heavy. El equipo host debe:
    • Ejecutar un sistema operativo admitido.
    • Estar conectado a una red de alta velocidad. Para obtener velocidades de copia más rápidas, se pueden utilizar dos conexiones de 40 GbE (una por nodo) en paralelo. Si no dispone de una conexión de 40 GbE, le recomendamos que tenga al menos dos conexiones de 10 GbE (una por nodo).
  5. Descargue AzCopy 7.1.0 en el equipo host. Usará AzCopy para copiar los datos desde el equipo host a Azure Data Box Blob Storage.

Conexión mediante http o https

Puede conectarse a Data Box Blob Storage mediante http o https.

  • Https es la forma segura y recomendada de conectarse al almacenamiento de blobs de Data Box.
  • Http se utiliza para conectarse en redes de confianza.

Los pasos para conectarse son diferentes cuando se conecta a Data Box Blob Storage mediante http o https.

Conexión mediante http

Estos son los pasos para conectarse a las API REST de Data Box Blob Storage mediante http:

  • Adición de la dirección IP de dispositivo y el punto de conexión de Blob service al host remoto
  • Configuración del software de terceros y comprobación de la conexión

En las secciones siguientes se describen todos estos pasos.

Importante

En Data Box Heavy, deberá repetir todas las instrucciones de conexión para conectarse al segundo nodo.

Adición de la dirección IP del dispositivo y el punto de conexión de Blob service

  1. Inicio de sesión en el dispositivo Data Box. Asegúrese de que está desbloqueado.

    Captura de pantalla que muestra el panel con el dispositivo mostrado como desbloqueado.

  2. Vaya a Establecer interfaces de red. Anote la dirección IP del dispositivo de la interfaz de red utilizada para conectar con el cliente.

    Captura de pantalla que muestra la configuración de red donde puede ver la dirección IP.

  3. Vaya a Conectar y copiar y haga clic en REST.

    Captura de pantalla que muestra el panel Conectar y copiar, donde puede seleccionar REST como opción de acceso.

  4. En el cuadro de diálogo Acceder a la cuenta de almacenamiento y cargar datos, copie el valor de Punto de conexión de Blob service.

    Captura de pantalla que muestra el cuadro de diálogo Acceder a la cuenta de almacenamiento y cargar datos, en el que puede copiar el punto de conexión de Blob Service.

  5. Inicie el Bloc de notas como administrador y abra el archivo hosts que se encuentra en C:\Windows\System32\Drivers\etc.

  6. Agregue la entrada siguiente a su archivo hosts: <device IP address> <Blob service endpoint>

  7. Como referencia, utilice la siguiente imagen. Guarde el archivo hosts.

    Captura de pantalla que muestra un documento del Bloc de notas con la dirección IP y el punto de conexión de Blob Service agregados.

Configuración del software de partners y comprobación de la conexión

Configuración del software de partner para conectar con el cliente. Para conectar con el software asociado, normalmente necesita la información siguiente (puede variar), que se recopila en la página Conectar y copiar de la interfaz de usuario web local del paso anterior:

  • Nombre de la cuenta de almacenamiento
  • Clave de acceso
  • Punto de conexión de Blob service

Para comprobar que la conexión se establece correctamente, use el Explorador de Storage para conectarse a una cuenta de almacenamiento externa. Si no tiene el Explorador de Storage, debe descargarlo e instalarlo.

La primera vez que usa el Explorador de Storage debe realizar los pasos siguientes:

  1. En la barra de comandos superior, vaya a Editar > Azure Stack de destino.

    Captura de pantalla que muestra la opción Target Azure Stack (Azure Stack de destino) seleccionada en el menú Editar.

  2. Reinicie el Explorador de Storage para que los cambios surtan efecto.

    Captura de pantalla que muestra el botón Reiniciar ahora.

Siga estos pasos para conectarse a la cuenta de almacenamiento y comprobar la conexión.

  1. En el Explorador de Storage, seleccione Connect to Azure Storage (Conectar con Azure Storage). En el cuadro de diálogo Connect to Azure Storage (Conectar con Azure Storage), seleccione Use a storage account name and key (Usar un nombre y una clave de cuenta de almacenamiento).

    Captura de pantalla en la que se muestra el cuadro de diálogo

  2. Pegue los valores de Account name (Nombre de cuenta) y Account key (Clave de cuenta) (valor de la clave 1 en la página Connect and copy en la interfaz de usuario web local). Seleccione el dominio de puntos de conexión de Storage como Other (enter below) [Otros (indicar a continuación)] y, después, proporcione el punto de conexión de Blob service como se muestra a continuación. Active la opción Use HTTP (Usar HTTP) solo si la transferencia se va a hacer mediante http. Si usa https, deje la opción desactivada. Seleccione Next (Siguiente).

    Captura de pantalla que muestra el cuadro de diálogo Conectarse con el nombre y la clave con los valores especificados.

  3. En el cuadro de diálogo Connection Summary (Resumen de conexiones), compruebe la información proporcionada. Seleccione Conectar.

    Captura de pantalla que muestra el cuadro de diálogo Resumen de conexiones con la opción Conectar seleccionada.

  4. La cuenta que ha agregado correctamente se muestra en el panel izquierdo del Explorador de Storage, con (External, Other) anexado al nombre. Haga clic en Contenedores de blobs para ver el contenedor.

    Captura de pantalla que muestra el menú Explorador con Contenedores de blobs seleccionados.

Conexión mediante https

Estos son los pasos para conectarse a las API REST de Azure Blob Storage mediante https:

  • Descarga del certificado desde Azure Portal
  • Importación del certificado en el cliente o el host remoto
  • Adición de la dirección IP del dispositivo y el punto de conexión de Blob service al cliente o al host remoto
  • Configuración del software de terceros y comprobación de la conexión

En las secciones siguientes se describen todos estos pasos.

Importante

En Data Box Heavy, deberá repetir todas las instrucciones de conexión para conectarse al segundo nodo.

Descargar certificado

Use Azure Portal para descargar el certificado.

  1. Inicie sesión en Azure Portal.

  2. Vaya a su pedido de Data Box y, a continuación, a General > Detalles del dispositivo.

  3. En Credenciales del dispositivo, vaya a Acceso de API al dispositivo. Haga clic en Descargar. Esta acción descarga un archivo de certificado <nombre del pedido>.cer. Guarde este archivo. Instalará este certificado en el equipo cliente o host que usará para conectarse al dispositivo.

    Descarga del certificado en Azure Portal

Importación de certificado

Para acceder al almacenamiento de blobs de Data Box a través de HTTPS, el dispositivo necesita un certificado TLS/SSL. La forma en que este certificado se pone a disposición de la aplicación cliente varía de una aplicación a otra y entre sistemas operativos y distribuciones. Algunas aplicaciones pueden acceder al certificado después de que se importa en el almacén de certificados del sistema, mientras que otras no hacen uso de ese mecanismo.

En esta sección se menciona información específica para algunas aplicaciones. Para más información sobre otras aplicaciones, consulte la documentación de la aplicación y el sistema operativo usado.

Siga estos pasos para importar el archivo .cer en el almacén raíz de un cliente de Windows o Linux. En un sistema Windows, puede usar Windows PowerShell o la interfaz de usuario de Windows Server para importar e instalar el certificado en el sistema.

Use Windows PowerShell

  1. Iniciar una sesión de Windows PowerShell como administrador.

  2. En el símbolo del sistema, escriba:

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

Uso de la interfaz de usuario de Windows Server

  1. Haga clic con el botón derecho en el archivo .cer y seleccione Instalar certificado. Esta acción inicia el Asistente para importar certificados.

  2. Para Ubicación de almacén, seleccione Equipo local y, después, haga clic en Siguiente.

    Importación del certificado mediante PowerShell

  3. Seleccione Colocar todos los certificados en el siguiente almacén y, luego, haga clic en Examinar. Navegue al almacén raíz del host remoto y, a continuación, haga clic en Siguiente.

    Importación del certificado mediante PowerShell 2

  4. Haga clic en Finalizar Aparece un mensaje que indica que la importación se ha realizado correctamente.

    Importación del certificado mediante PowerShell 3

Uso de un sistema Linux

El método para importar un certificado varía según la distribución.

Importante

En Data Box Heavy, deberá repetir todas las instrucciones de conexión para conectarse al segundo nodo.

Varias, como Ubuntu y Debian, usan el comando update-ca-certificates.

  • Cambie el nombre del archivo de certificado codificado en Base64 para tener una extensión .crt y cópielo en /usr/local/share/ca-certificates directory.
  • Ejecute el comando update-ca-certificates.

Las versiones recientes de RHEL, Fedora y CentOS usan el comando update-ca-trust.

  • Copie el archivo de certificado en el directorio /etc/pki/ca-trust/source/anchors.
  • Ejecute update-ca-trust.

Para más información, consulte la documentación específica para su distribución.

Adición de la dirección IP del dispositivo y el punto de conexión de Blob service

Siga los mismos pasos para agregar la dirección IP del dispositivo y el punto de conexión de Blob service cuando se conecta mediante http.

Configuración del software de partners y comprobación de la conexión

Siga los pasos para configurar el software de asociado que usó durante la conexión mediante http. La única diferencia es que debe dejar la opción Usar http desactivada.

Copia de datos a Data Box Heavy

Una vez que esté conectado a Data Box Blob Storage, el siguiente paso es copiar los datos. Antes de copiar los datos, revise las consideraciones siguientes:

  • Al copiar los datos, asegúrese de que el tamaño de los datos se ajusta a los límites de Azure Storage y Data Box Heavy.
  • Si los datos que va a cargar el dispositivo Data Box Heavy los están cargando a la vez otras aplicaciones fuera del dispositivo Data Box Heavy, podría provocar errores en el trabajo de carga y daños en los datos.

En este tutorial, se usa AzCopy para copiar los datos al Data Box Blob Storage. También puede usar el Explorador de Azure Storage (si lo prefiere una herramienta basada en GUI) o un software de partner para copiar los datos.

El procedimiento de copia incluye los siguientes pasos:

  • Crear un contenedor
  • Cargar el contenido de una carpeta en Data Box Blob Storage
  • Cargar los archivos modificados en Data Box Blob Storage

En las siguientes secciones se describen estos pasos.

Importante

En Data Box Heavy, deberá repetir todas las instrucciones de copia para copiar los datos en el segundo nodo.

Crear un contenedor

El primer paso es crear un contenedor, ya que los blobs siempre se cargan en un contenedor. Los contenedores organizan grupos de blobs de la misma forma que se organizan archivos en las carpetas de un equipo. Siga estos pasos para crear un contenedor de blobs:

  1. Abra el Explorador de Storage.

  2. En el panel izquierdo, expanda la cuenta de almacenamiento en la que desea crear el contenedor de blobs.

  3. Haga clic con el botón derecho en Contenedores de blobs y, en el menú contextual, seleccione Crear contenedor de blobs.

    Menú contextual Crear contenedores de blobs

  4. Aparecerá un cuadro de texto debajo de la carpeta Contenedores de blobs. Escriba el nombre del contenedor de blobs. Para más información sobre las reglas y restricciones en la nomenclatura de los contenedores de blobs, consulte Creación del contenedor y establecimiento de los permisos.

  5. Presione ENTRAR cuando termine para crear el contenedor de blobs o Esc para cancelar la operación. Una vez que el contenedor de blobs se ha creado correctamente, se mostrará en la carpeta Contenedores de blobs de la cuenta de almacenamiento seleccionada.

    Contenedor de blobs creado

Cargar el contenido de una carpeta en Data Box Blob Storage

Use AzCopy para cargar todos los archivos en una carpeta en Blob Storage en Windows o Linux. Para cargar todos los blobs en una carpeta, escriba el siguiente comando de 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

Reemplace <key> por la clave de cuenta. Para obtener la clave de cuenta, en Azure Portal, vaya a su cuenta de almacenamiento. Vaya a Configuración > Claves de acceso, seleccione una clave y péguela en el comando de AzCopy.

Si el contenedor de destino especificado no existe, AzCopy lo crea y carga el archivo en él. Actualice la ruta de acceso de origen al directorio de datos y reemplace data-box-storage-account-name en la dirección URL de destino por el nombre de la cuenta de almacenamiento asociada a su dispositivo Data Box.

Para cargar el contenido del directorio especificado repetidamente en Blob Storage, especifique la opción --recursive (Linux) o /S (Windows). Al ejecutar AzCopy con una de estas opciones, se cargan también todas las subcarpetas y sus archivos.

Cargar los archivos modificados en Data Box Blob Storage

Use AzCopy para cargar archivos según la hora de la última modificación. Para probar esto, modifique o cree archivos en el directorio de origen para fines de prueba. Para cargar solo los archivos nuevos o actualizados, agregue el parámetro --exclude-older (Linux) o /XO (Windows) al comando AzCopy.

Si solo desea copiar los recursos de origen que no existen en el destino, especifique ambos parámetros --exclude-older y --exclude-newer (Linux) o /XO y /XN (Windows) en el comando de AzCopy. AzCopy carga solo los datos actualizados, en función de su marca de tiempo.

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

Si se han producido errores durante la operación de copia o de conexión, consulte Solución de problemas relacionados con el almacenamiento de blobs de Data Box.

El siguiente paso consiste en preparar el dispositivo para el envío.

Pasos siguientes

En este tutorial, ha obtenido información acerca de varios temas relacionados con Azure Data Box, como:

  • Prerrequisitos
  • Conexión a Data Box Blob Storage mediante http o https
  • Copia de datos a Data Box Heavy

En el siguiente tutorial aprenderá a enviar su dispositivo Data Box a Microsoft.

Envío del dispositivo Azure Data Box Heavy a Microsoft