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

2024-02-27

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. Después de configurar el rol de proceso, Azure Stack Edge Pro FPGA puede transformar los datos antes de enviarlos a Azure.

La capacidad de cómputo puede configurarse para un flujo de implementación sencilla o avanzada en tu dispositivo.

Criterios	Implementación sencilla	Implementación avanzada
Diseñado para	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	Soltero	Múltiples 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 acciones
Adición de un desencadenador
Añadir un módulo de cálculo
Comprobación de la transformación y transferencia de datos

Prerrequisitos

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 como se describe en Conectar, configurar y activar Azure Stack Edge Pro FPGA.

Configurar el proceso

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

En el portal de Azure de su recurso de Azure Stack Edge, vaya a Visión general. En el panel derecho, seleccione el icono de IoT Edge.

de computación
En el icono Enable IoT Edge service (Habilitar servicio IoT Edge), seleccione Add (Agregar). Mediante esta acción se habilita el servicio IoT Edge, que permite implementar módulos de IoT Edge localmente en tu dispositivo.

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

Campo	Valor
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.
Grupo de recursos	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 cómputo 3

Seleccione Revisar y Crear. La creación de recursos de IoT Hub tarda un par de minutos. Una vez creado el recurso de IoT Hub, la Información general se actualiza para indicar que el servicio IoT Edge se está ejecutando.

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

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

Agregar acciones

En este tutorial de implementación avanzada, necesitarás dos recursos compartidos: uno de Edge y otro local de Edge.

Para agregar un recurso compartido de Edge en el dispositivo, siga estos pasos:
1. En el recurso de Azure Stack Edge, vaya a IoT Edge > Shares.
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 de Edge, active la casilla de Utilizar el recurso con Edge compute.
5. Seleccione la cuenta de almacenamiento , el servicio de almacenamiento , un usuario existente, y, a continuación, seleccione Crear.
Una vez creado el recurso compartido Edge, recibirá una notificación de creación exitosa. La lista de comparticiones se actualiza para reflejar la nueva compartición.
Agregue una compartición local de Edge en el dispositivo Edge volviendo a realizar todos los pasos del paso anterior y marcando la casilla de Configurar como compartición local de Edge. Los datos de la compartición 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, seleccione el recurso de la lista. En el cuadro Punto de montaje local para módulos de computación de Edge, copie el valor correspondiente a esta participación.

Usará este punto de montaje local al implementar el módulo.
Para ver las propiedades del recurso compartido de Edge que creó, selecciónelo de la lista. En el cuadro Punto de montaje local para módulos de computación de Edge, copie el valor correspondiente a esta participación.

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

Adición de un desencadenador

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

En el panel Agregar desencadenador, introduzca los siguientes valores.

Campo	Valor
Nombre del desencadenador	Un nombre único para el desencadenador.
Tipo de desencadenador	Seleccione Archivo como desencadenante. Un desencadenador de archivo se activa cada vez que ocurre un evento de archivo, como cuando un archivo se escribe 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.
Participación de entrada	Seleccione una compartición de entrada. El recurso compartido local de Edge es el recurso compartido de entrada en este caso. El módulo que se usa aquí mueve los archivos del recurso compartido local de Edge a un recurso compartido de Edge donde se cargan en la nube.

Agregar desencadenador 2

Se le notificará después de que 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\")"

Adición de un módulo

No hay módulos personalizados en este dispositivo Edge. Puede agregar un módulo personalizado o pregenerado. Para obtener información sobre cómo crear un módulo personalizado, vaya a Desarrollo de un módulo de C# para el dispositivo Azure Stack Edge Pro FPGA.

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

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 IoT Edge asociado con su Azure Stack Edge Pro con FPGA.
URI de imagen	URI de imagen para la imagen de contenedor correspondiente para el módulo.
Credenciales necesarias	Si se comprueba, el nombre de usuario y la contraseña se usan para recuperar 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 compartido de Edge y el compartido local de Edge.

Importante

Las rutas de acceso utilizadas aquí se montan en tu contenedor, por lo que deben coincidir con lo que la funcionalidad de tu contenedor espera. Si está siguiendo Crear un módulo personalizado, el código especificado en ese módulo espera las rutas 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 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 en ejecución según lo previsto. El estado en tiempo de ejecución del módulo debería estar en ejecución para su dispositivo IoT Edge en el 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 tanto al local de Edge como a los recursos compartidos de Edge que creó anteriormente.
Agregue datos al compartido local.

Los datos se trasladan al recurso compartido en la nube.

A continuación, los datos se insertan desde el 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.