Tutorial: Transformación de datos con Azure Stack Edge Pro con FPGA para el flujo de implementación avanzada

Artículo
02/27/2024

Importante

Los dispositivos de Azure Stack Edge Pro FPGA llegaron al final del ciclo de vida en febrero de 2024.

En este tutorial se describe cómo configurar el rol de proceso para un flujo de implementación avanzada en un dispositivo de Azure Stack Edge Pro con FPGA. Una vez configurado el rol de proceso, Azure Stack Edge Pro con FPGA puede transformar los datos antes de enviarlos a Azure.

El proceso puede configurarse para un flujo de implementación sencilla o avanzada en el dispositivo.

Criterios	Implementación sencilla	Implementación avanzada
Destinado a	Administradores de TI	Desarrolladores
Tipo	Usar el servicio Azure Stack Edge para implementar módulos	Usar el servicio IoT Hub para implementar módulos
Módulos implementados	Single	Varios módulos o módulos en cadena

Este procedimiento tarda aproximadamente entre 20 y 30 minutos en completarse.

En este tutorial, aprenderá a:

Configurar el proceso
Agregar recursos compartidos
Incorporación de un desencadenador
Agregar un módulo de proceso
Comprobar la transformación y la transferencia de los datos

Requisitos previos

Antes de configurar un rol de proceso en el dispositivo Azure Stack Edge Pro FPGA, asegúrese de que:

Ha activado el dispositivo Azure Stack Edge Pro FPGA tal y como se describe en Tutorial: Conexión, configuración y activación de Azure Stack Edge Pro FPGA.

Configurar el proceso

Para configurar el proceso en Azure Stack Edge Pro FPGA, creará un recurso de IoT Hub.

En la instancia de Azure Portal del recurso de Azure Stack Edge, vaya a Información general. En el panel derecho, seleccione el icono de IoT Edge.
En el icono Enable IoT Edge service (Habilitar servicio IoT Edge), seleccione Add (Agregar). Mediante esta acción se el servicio IoT Edge, que permite implementar módulos de IoT Edge en el dispositivo.

En Create IoT Edge service (Crear servicio IoT Edge), escriba lo siguiente:

Campo	Value
Suscripción	Seleccione una suscripción para el recurso de IoT Hub. Puede seleccionar la misma suscripción que usa el recurso de Azure Stack Edge.
Resource group	Escriba un nombre para el grupo de recursos del recurso de IoT Hub. Puede seleccionar el mismo grupo de recursos que usa el recurso de Azure Stack Edge.
IoT Hub	Elija entre Nuevo o Existente. De forma predeterminada, se usa un nivel estándar (S1) para crear un recurso de IoT. Para usar un recurso de IoT de nivel gratuito, cree uno y, a continuación, seleccione el recurso existente.
Nombre	Accepte el valor predeterminado o escriba un nombre para el recurso de IoT Hub.

Introducción al proceso 3

Seleccione Revisar + crear. La creación del recurso de IoT Hub tarda unos minutos. Una vez creado el recurso de IoT Hub, Overview (Información general) se actualiza e indica que el servicio IoT Edge está en ejecución.

Cuando el servicio IoT Edge está configurado en el dispositivo Edge, este crea dos dispositivos: uno IoT y el otro IoT Edge. Ambos se pueden ver en el recurso de IoT Hub. Un entorno de ejecución de IoT Edge también se ejecuta en este dispositivo de IoT Edge. En este momento, solo está disponible la plataforma Linux para el dispositivo IoT Edge.

Para confirmar que se ha configurado el rol de proceso de Edge, seleccione el servicio IoT Edge > Propiedades y consulte el dispositivo de IoT y el dispositivo de IoT Edge.

Agregar recursos compartidos

En este tutorial, se realizará una implementación avanzada con dos recursos compartidos: un recurso compartido perimetral y otro recurso compartido local perimetral.

Para agregar un recurso compartido perimetral al dispositivo, siga estos pasos:
1. En el recurso de Azure Stack Edge, vaya a IoT Edge > Recursos compartidos.
2. En la página Shares (Recursos compartidos), en la barra de comandos, seleccione + Add share (+ Agregar recurso compartido).
3. En la hoja Agregar recurso compartido, proporcione el nombre del recurso compartido y seleccione el tipo de recurso compartido.
4. Para montar el recurso compartido perimetral, active la casilla Usar el recurso compartido con el proceso perimetral.
5. Seleccione la cuenta de almacenamiento, el servicio de almacenamiento, un usuario existente y, luego, Crear.
Una vez creado el recurso compartido perimetral, recibirá una notificación para indicar que la creación se realizó correctamente. La lista de recursos compartidos se actualiza para reflejar el nuevo recurso compartido.
Para agregar un recurso compartido local perimetral al dispositivo perimetral, repita todos los pasos anteriores y active la casilla Configurar como recurso compartido local de Edge. Los datos en el recurso compartido local permanecen en el dispositivo.
En la hoja Recursos compartidos, consulte la lista actualizada de los recursos compartidos.
Para ver las propiedades del recurso compartido local recién creado, selecciónelo en la lista. En el cuadro Punto de montaje local para módulos de proceso de Edge, copie el valor correspondiente a este recurso compartido.

Usará este punto de montaje local al implementar el módulo.
Para ver las propiedades del recurso compartido perimetral creado, selecciónelo en la lista. En el cuadro Punto de montaje local para módulos de proceso de Edge, copie el valor correspondiente a este recurso compartido.

Usará este punto de montaje local al implementar el módulo.

Incorporación de un desencadenador

Vaya al recurso de Azure Stack Edge y, después, a IoT Edge > Desencadenadores. Seleccione + Agregar desencadenador.

En la hoja Agregar desencadenador, introduzca los siguientes valores.

Campo	Value
Nombre del desencadenador	Un nombre exclusivo para el concentrador.
Tipo de desencadenador	Seleccione el desencadenador Archivo. Un desencadenador de archivo se activa cada vez que se produce un evento de archivo, por ejemplo, cuando se escribe un archivo en el recurso compartido de entrada. Por otra parte, un desencadenador programado se activa según una programación definida por el usuario. En este ejemplo, necesitamos un desencadenador de archivo.
Recurso compartido de entrada	Seleccione un recurso compartido de entrada. En este caso, el recurso compartido local perimetral es el recurso compartido de entrada. El módulo que se usa aquí mueve los archivos desde el recurso compartido local perimetral hasta un recurso compartido perimetral donde se cargan en la nube.

Agregar desencadenador 2

Recibirá una notificación cuando el desencadenador se cree. La lista de desencadenadores se actualiza para mostrar el desencadenador recién creado. Seleccione el desencadenador que acaba de crear.
Copie y guarde la ruta de ejemplo. Modificará esta ruta de ejemplo y la usará más adelante en IoT Hub.

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

Agregar un módulo

No hay módulos personalizados en este dispositivo perimetral. Puede agregar un módulo personalizado o uno creado previamente. Para aprender a crear un módulo personalizado, vaya a Desarrollo de un módulo C# para un dispositivo de Azure Stack Edge Pro con FPGA.

En esta sección, agregará un módulo personalizado al dispositivo IoT Edge que creó en Desarrollo de un módulo IoT Edge en C# para mover archivos con Azure Stack Edge Pro FPGA. Este módulo personalizado toma los archivos de un recurso compartido local perimetral del dispositivo perimetral y los mueve a un recurso compartido perimetral (nube) del dispositivo. A continuación, el recurso compartido en la nube inserta los archivos en la cuenta de Azure Storage asociada con este.

Vaya al recurso de Azure Stack Edge y, después, a IoT Edge > Información general. En el icono Modules (Módulos), seleccione Go to Azure IoT Hub (Ir a Azure IoT Hub).

En el recurso de IoT Hub, vaya a Dispositivo IoT Edge y, a continuación, seleccione el dispositivo correspondiente.
En Detalles del dispositivo, seleccione Establecer módulos.

En Agregar módulos, haga lo siguiente:

Proporcione el nombre, dirección, nombre de usuario y contraseña de la configuración del Registro del contenedor para el módulo personalizado. El nombre, la dirección y las credenciales mostradas se utilizan para recuperar aquellos módulos con una dirección URL que coincida. Para implementar este módulo, en Módulos de implementación, seleccione Módulo de IoT Edge. Este módulo de IoT Edge es un contenedor de Docker que puede implementar en un dispositivo de IoT Edge asociado con el dispositivo de Azure Stack Edge Pro con FPGA.

Especifique la configuración para el módulo personalizado de IoT Edge. Escriba los siguientes valores.

Campo	Valor
Nombre	Un nombre único para el módulo. Este módulo es un contenedor de Docker que puede implementar en el dispositivo de IoT Edge asociado a Azure Stack Edge Pro con FPGA.
URI de imagen	El URI de la imagen de contenedor correspondiente del módulo.
Credenciales necesarias	Si está activada, se usa el nombre de usuario y la contraseña para recuperar los módulos con una dirección URL coincidente.

En el cuadro Opciones de creación del contenedor, escriba los puntos de montaje local para los módulos de Edge que ha copiado en los pasos anteriores para el recurso compartido perimetral y el recurso compartido local perimetral.

Importante

Las rutas de acceso que se usan aquí se montan en el contenedor, por lo que deben coincidir con la funcionalidad esperada en el contenedor. Si sigue Creación de un módulo personalizado, el código especificado en dicho módulo espera las rutas de acceso copiadas. No modifique estas rutas de acceso.

En el cuadro Opciones de creación del contenedor, puede pegar el ejemplo siguiente:

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

Proporcione todas las variables de entorno utilizadas para el módulo. Las variables de entorno ofrecen información opcional que le ayudará a definir el entorno en que se ejecuta su módulo.

El cuadro Opciones de creación del contenedor

Si es necesario, configure las opciones avanzadas del entorno de ejecución de Edge y, a continuación, haga clic en Siguiente.

En Especificar rutas, defina las rutas entre módulos.

Puede reemplazar la ruta por la cadena de ruta siguiente copiada anteriormente. En este ejemplo, proporcione el nombre del recurso compartido local que insertará los datos en el recurso compartido en la nube. Reemplace modulename por el nombre del módulo. Seleccione Next (Siguiente).
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
En Revisar la implementación, revise todos los valores y, después, seleccione Enviar a fin de enviar el módulo para la implementación.

Esta acción inicia la implementación del módulo. Una vez completada la implementación, el Estado en tiempo de ejecución del módulo es En ejecución.

Comprobar la transformación y la transferencia de los datos

El último paso es asegurarse de que el módulo está conectado y funciona según lo previsto. El estado del entorno de ejecución del módulo debe ser "en ejecución" para el dispositivo IoT Edge del recurso de IoT Hub.

Realice los pasos siguientes para verificar la transformación de los datos y la transferencia a Azure.

En el Explorador de archivos, conéctese a los recursos compartidos local perimetral y perimetral que creó anteriormente.
Agregue datos al recurso compartido local.

Los datos se mueven al recurso compartido en la nube.

A continuación, los datos se trasladan del recurso compartido en la nube a la cuenta de almacenamiento. Para ver los datos, vaya a la cuenta de almacenamiento y, a continuación, seleccione Explorador de Storage. Puede ver los datos cargados en la cuenta de almacenamiento.