Tutoriel : Transformer des données avec Azure Stack Edge Pro FPGA pour un flux de déploiement avancé

Ce tutoriel explique comment configurer un rôle de calcul pour un flux de déploiement avancé sur votre appareil Azure Stack Edge Pro FPGA. Après avoir configuré le rôle de calcul, Azure Stack Edge Pro FPGA peut transformer des données avant de les envoyer à Azure.

Le calcul peut être configuré pour un flux de déploiement simple ou avancé sur votre appareil.

Cette procédure peut prendre environ 20 à 30 minutes.

Dans ce tutoriel, vous allez apprendre à :

Conditions préalables

Avant de configurer un rôle de calcul sur votre appareil Azure Stack Edge Pro FPGA, assurez-vous que :

• Vous avez activé votre appareil Azure Stack Edge Pro FPGA comme décrit dans Connecter, configurer et activer Azure Stack Edge Pro FPGA.

Configurer le calcul

Pour configurer le calcul sur votre FPGA Azure Stack Edge Pro, vous allez créer une ressource IoT Hub.

1. Dans le portail Azure de votre ressource Azure Stack Edge, accédez à Vue d’ensemble. Dans le volet de droite, sélectionnez le widget IoT Edge.

   Introduction à

2. Dans la vignette Activer le service IoT Edge, sélectionnez Ajouter. Cette action active le service IoT Edge qui vous permet de déployer des modules IoT Edge localement sur votre appareil.

   

3. Dans le Créer un service IoT Edge, entrez les éléments suivants :

   Champ	Valeur
   Abonnement	Sélectionnez un abonnement pour votre ressource IoT Hub. Vous pouvez sélectionner le même abonnement que celui utilisé par la ressource Azure Stack Edge.
   Groupe de ressources	Entrez un nom pour le groupe de ressources de votre ressource IoT Hub. Vous pouvez sélectionner le même groupe de ressources que celui utilisé par la ressource Azure Stack Edge.
   IoT Hub	Choisissez parmi nouveau ou existant. Par défaut, un niveau Standard (S1) est utilisé pour créer une ressource IoT. Pour utiliser une ressource IoT de niveau gratuit, créez-en une, puis sélectionnez la ressource existante.
   Nom	Acceptez la valeur par défaut ou entrez un nom pour votre ressource IoT Hub.

   

4. Sélectionnez Vérifier + Créer. La création de ressources IoT Hub prend quelques minutes. Une fois la ressource IoT Hub créée, la Vue d’ensemble se met à jour pour indiquer que le service IoT Edge est en cours d’exécution.

   Lorsque le service IoT Edge est configuré sur l’appareil Edge, il crée deux appareils : un appareil IoT et un appareil IoT Edge. Les deux appareils peuvent être consultés dans la ressource IoT Hub. Un runtime IoT Edge s’exécute également sur cet appareil IoT Edge. À ce stade, seule la plateforme Linux est disponible pour votre appareil IoT Edge.

   Pour vérifier que le rôle de calcul Edge a été configuré, sélectionnez service IoT Edge > Propriétés et affichez l’appareil IoT et l’appareil IoT Edge.

   

Ajouter des actions

Pour le déploiement avancé dans ce tutoriel, vous aurez besoin de deux partages : un partage Edge et un autre partage local Edge.

1. Ajoutez un partage Edge sur l’appareil en procédant comme suit :

   1. Dans votre ressource Azure Stack Edge, accédez à IoT Edge > Partages.

   2. Dans la barre de commandes de la page Partages, sélectionnez + Ajouter un partage.

   3. Dans le panneau Ajouter un partage, indiquez le nom du partage et sélectionnez le type de partage.

   4. Pour monter le partage Edge, cochez la case correspondante pour Utiliser le partage avec la fonction Edge de calcul informatique.

   5. Sélectionnez le compte de stockage , le service de stockage , un utilisateur existant, puis sélectionnez Créer .

      

   Une fois le partage Edge créé, vous recevrez une notification de création réussie. La liste de partages est mise à jour pour refléter le nouveau partage.

2. Ajoutez un partage local Edge sur l’appareil Edge en répétant toutes les étapes de l’étape précédente et en cochant la case pour Configurer en tant que partage local Edge. Les données du partage local restent sur l’appareil.

   

3. Dans l'onglet Partages, vous voyez la liste mise à jour des partages.

   

4. Pour afficher les propriétés du partage local nouvellement créé, sélectionnez le partage dans la liste. Dans la zone Point de montage local pour les modules de calcul Edge, copiez la valeur correspondant à ce partage.

   Vous utiliserez ce point de montage local lorsque vous déployez le module.

   

5. Pour afficher les propriétés du partage Edge que vous avez créé, sélectionnez le partage dans la liste. Dans la zone Point de montage local pour les modules de calcul Edge, copiez la valeur correspondant à ce partage.

   Vous utiliserez ce point de montage local lorsque vous déployez le module.

   

Ajouter un déclencheur

1. Accédez à votre ressource Azure Stack Edge, puis accédez à IoT Edge > Déclencheurs. Sélectionnez + Ajouter un déclencheur.

   

2. Dans la fenêtre Ajouter un déclencheur, insérez les valeurs suivantes.

   Champ	Valeur
   Nom du déclencheur	Nom unique de votre déclencheur.
   Type de déclencheur	Sélectionnez le déclencheur de fichier . Un déclencheur de fichier se déclenche chaque fois qu’un événement de fichier se produit, tel qu’un fichier est écrit dans le partage d’entrée. En revanche, un déclencheur planifié est déclenché en fonction d’une planification définie par vous. Pour cet exemple, nous avons besoin d’un déclencheur de fichier.
   Partage des données d'entrée	Sélectionnez un partage d’entrée. Le partage local d'Edge constitue le partage d'entrée dans ce cas. Le module utilisé ici déplace les fichiers du partage local Edge vers un partage Edge où ils sont chargés dans le cloud.

   

3. Vous êtes averti après la création du déclencheur. La liste des déclencheurs est mise à jour pour afficher le déclencheur nouvellement créé. Sélectionnez le déclencheur que vous venez de créer.

   

4. Copiez et enregistrez l’exemple d’itinéraire. Vous allez modifier cet exemple d’itinéraire et l’utiliser ultérieurement dans IoT Hub.

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

   

Ajouter un module

Il n’existe aucun module personnalisé sur cet appareil Edge. Vous pouvez ajouter un module personnalisé ou prédéfini. Pour savoir comment créer un module personnalisé, accédez à Développer un module C# pour votre appareil Azure Stack Edge Pro FPGA.

Dans cette section, vous allez ajouter un module personnalisé à l’appareil IoT Edge que vous avez créé dans Développer un module C# pour votreAzure Stack Edge Pro FPGA . Ce module personnalisé prend des fichiers à partir d’un partage local Edge sur l’appareil Edge et les déplace vers un partage Edge (cloud) sur l’appareil. Le partage cloud envoie ensuite les fichiers au compte de stockage Azure associé au partage cloud.

1. Accédez à votre ressource Azure Stack Edge, puis accédez à IoT Edge > Vue d’ensemble. Dans la vignette Modules, sélectionnez Accéder à Azure IoT Hub.

   

2. Dans votre ressource IoT Hub, accédez à l'appareil IoT Edge , puis sélectionnez votre appareil IoT Edge.

   IoT Hub

3. Dans les détails de l’appareil, sélectionnez Configurer les modules.

   

4. Sous Ajouter des modules, procédez comme suit :

   1. Entrez le nom, l’adresse, le nom d’utilisateur et le mot de passe pour les paramètres du registre de conteneurs pour le module personnalisé. Le nom, l’adresse et les informations d’identification listées sont utilisés pour récupérer des modules avec une URL correspondante. Pour déployer ce module, sous modules de déploiement, sélectionnez module IoT Edge. Ce module IoT Edge est un conteneur Docker que vous pouvez déployer sur l’appareil IoT Edge associé à votre appareil Azure Stack Edge Pro FPGA.

      

   2. Spécifiez les paramètres du module personnalisé IoT Edge. Entrez les valeurs suivantes.

      Champ	Valeur
      Nom	Nom unique du module. Ce module est un conteneur Docker que vous pouvez déployer sur l’appareil IoT Edge associé à votre FPGA Azure Stack Edge Pro.
      URI de l'image	URI de l'image conteneur correspondante pour le module.
      Informations d’identification requises	Si cette option est cochée, le nom d’utilisateur et le mot de passe sont utilisés pour récupérer des modules avec une URL correspondante.

      Dans la zone Options de création de conteneur, entrez les points de montage locaux des modules Edge que vous avez copiés dans les étapes précédentes pour le partage Edge et le partage local Edge.

      Important

      Les chemins utilisés ici sont montés dans votre conteneur. Ils doivent donc correspondre à la fonctionnalité attendue dans votre conteneur. Si vous suivez Créer un module personnalisé, le code spécifié dans ce module attend les chemins copiés. Ne modifiez pas ces chemins d’accès.

      Dans la zone Options de création de conteneur, vous pouvez coller l’exemple suivant :

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

      Fournissez les variables environnementales utilisées pour votre module. Les variables environnementales fournissent des informations facultatives qui aident à définir l’environnement dans lequel votre module s’exécute.

      

   3. Si nécessaire, configurez les paramètres avancés du runtime Edge, puis cliquez sur Suivant.

      

5. Sous Spécifier des itinéraires, définissez des itinéraires entre les modules.

   

   Vous pouvez remplacer route par la chaîne de routage suivante que vous avez copiée précédemment. Dans cet exemple, entrez le nom du partage local qui envoie des données au partage cloud. Remplacez le modulename par le nom du module. Sélectionnez suivant.

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

   

6. Sous Revoir le déploiement, vérifiez tous les paramètres, puis sélectionnez Envoyer pour soumettre le module au déploiement.

   

   Cette action démarre le déploiement du module. Une fois le déploiement terminé, l’état d’exécution du module est en cours de fonctionnement.

   

Vérifier la transformation des données, le transfert

La dernière étape consiste à s’assurer que le module est connecté et s’exécute comme prévu. L’état d’exécution du module doit être actif pour votre appareil IoT Edge au sein de la ressource IoT Hub.

Procédez comme suit pour vérifier la transformation et le transfert des données vers Azure.

1. Dans l’Explorateur de fichiers, connectez-vous au partage local Edge ainsi qu'aux partages Edge que vous avez créés précédemment.

   

2. Ajoutez des données au partage local.

   

   Les données sont déplacées vers le partage cloud.

   

   Les données sont ensuite envoyées du partage cloud au compte de stockage. Pour afficher les données, accédez à votre compte de stockage, puis sélectionnez Explorateur Stockage. Vous pouvez afficher les données chargées dans votre compte de stockage.

   

Vous avez terminé le processus de validation.

Étapes suivantes

Dans ce tutoriel, vous avez appris à :

Pour savoir comment administrer votre appareil Azure Stack Edge Pro FPGA, consultez :