Créer et approvisionner un appareil IoT Edge pour Linux sur Windows à l’aide de clés symétriques

Un hub IoT gratuit ou standard dans votre abonnement Azure.

• Un hub IoT gratuit ou standard dans votre abonnement Azure
• Visual Studio Code
• Extension Azure IoT Hub
• Azure IoT Edge pour Visual Studio Code

• Un hub IoT gratuit ou standard dans votre abonnement Azure

• Azure CLI dans votre environnement

  Vous devez utiliser Azure CLI version 2.0.70 ou ultérieure. Utilisez az --version pour valider. Cette version prend en charge les commandes d’extension az et introduit l’infrastructure de la commande Knack.

Si vous souhaitez utiliser PowerShell, suivez les étapes ci-dessous pour préparer votre appareil cible à l’installation d’Azure IoT Edge pour Linux sur Windows et au déploiement de la machine virtuelle Linux :

1. Définissez la stratégie d’exécution sur l’appareil cible sur AllSigned. Vous pouvez vérifier la stratégie d’exécution actuelle dans une invite PowerShell avec élévation de privilèges à l’aide de la commande suivante :

   Get-ExecutionPolicy -List
   

   Si la stratégie d’exécution de local machine n’est pas AllSigned, vous pouvez la définir à l’aide de :

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Pour en savoir plus sur le module PowerShell d’Azure IoT Edge pour Linux sur Windows, consultez la documentation de référence sur les fonctions PowerShell.

Si vous souhaitez utiliser Windows Admin Center, suivez les étapes ci-dessous pour télécharger et installer Windows Admin Center et installer l’extension Azure IoT Edge de Windows Admin Center :

1. Téléchargez et exécutez le programme d’installation de Windows Admin Center. Suivez les invites de l’Assistant Installation pour installer Windows Admin Center.

2. Une fois l’installation terminée, utilisez un navigateur pris en charge pour ouvrir le Windows Admin Center. Les navigateurs pris en charge sont Microsoft Edge (Windows 10, version 1709 ou ultérieure), Google Chrome et Microsoft Edge Insider.

3. Lors de la première utilisation de Windows Admin Center, vous êtes invité à sélectionner le certificat à utiliser. Sélectionnez Client Windows Admin Center comme certificat.

4. Installez l’extension Azure IoT Edge. Sélectionnez l’icône d’engrenage en haut à droite du tableau de bord de Windows Admin Center.

   

5. Dans le menu Paramètres, sous Passerelle, sélectionnez Extensions.

6. Dans l’onglet Extensions disponibles, recherchez Azure IoT Edge dans la liste des extensions. Sélectionnez-le et cliquez sur l’invite Installer au-dessus de la liste des extensions.

7. Une fois l’installation terminée, Azure IoT Edge doit apparaître dans la liste des extensions installées dans l’onglet Extensions installées.

Dans votre hub IoT dans le portail Azure, les appareils IoT Edge sont créés et managés séparément des appareils IoT qui ne sont pas compatibles avec Edge.

1. Connectez-vous au portail Azure et accédez à votre IoT Hub.

2. Dans le volet de gauche, sélectionnez Appareils dans le menu, puis sélectionnez Ajouter un appareil.

3. Dans la page Créer un appareil, fournissez les informations suivantes :

   • Créez un ID d’appareil descriptif. Notez cet ID d’appareil, car vous en aurez besoin plus tard.
   • Cochez la case Appareil IoT Edge.
   • Sélectionnez Clé symétrique comme type d’authentification.
   • Utilisez les paramètres par défaut pour générer automatiquement les clés d’authentification et connecter le nouvel appareil à votre hub.

4. Cliquez sur Enregistrer.

Se connecter pour accéder à votre hub ioT

Vous pouvez utiliser les extensions Azure IoT pour Visual Studio Code afin d’effectuer des opérations avec votre hub IoT. Pour que ces opérations fonctionnent, vous devez vous connecter à votre compte Azure et sélectionner votre hub.

1. Dans Visual Studio Code, ouvrez la vue Explorateur.

2. Au bas de l’Explorateur, développez la section Azure IoT Hub.

   

3. Cliquez sur ... dans l’en-tête de section Azure IoT Hub. Si vous ne voyez pas les points de suspension, cliquez ou pointez sur l’en-tête.

4. Choisissez Sélectionner un hub IoT.

5. Si vous n’êtes pas connecté à votre compte Azure, suivez les invites de connexion.

6. Sélectionnez votre abonnement Azure.

7. Sélectionnez votre hub IoT.

Inscrire un nouvel appareil avec Visual Studio Code

1. Dans l’explorateur Visual Studio Code, développez la section Azure IoT Hub.
2. Cliquez sur ... dans l’en-tête de section Azure IoT Hub. Si vous ne voyez pas les points de suspension, cliquez ou pointez sur l’en-tête.
3. Sélectionnez Créer un appareil IoT Edge.
4. Dans la zone de texte qui s’ouvre, donnez un ID à votre appareil.

Dans l’écran de sortie, vous voyez le résultat de la commande. Les informations de l’appareil apparaissent, notamment l’ID d’appareil (deviceId) que vous avez fourni et la chaîne de connexion (connectionString) qui vous permet de connecter votre appareil physique à votre hub IoT.

Utilisez la commande az iot hub device-identity create pour créer une identité d’appareil dans votre hub IoT. Par exemple :

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

Cette commande inclut trois paramètres :

• --device-id ou -d : fournissez un nom descriptif unique dans votre hub IoT.

• --hub-name ou -n : indiquez le nom de votre hub IoT.

• --edge-enabled ou --ee : déclarez que l’appareil est un appareil IoT Edge.

  

Les appareils compatibles avec Edge qui se connectent à votre hub IoT sont répertoriés dans la page Appareils. Vous pouvez filtrer la liste par type d’Appareil Iot Edge.

Pour configurer votre appareil, vous avez besoin de la chaîne de connexion qui établit un lien entre votre appareil physique et son identité dans le hub IoT.

Les appareils qui s’authentifient avec des clés symétriques disposent des chaînes de connexion pouvant être copiées dans le portail.

1. Dans la page Appareils du portail, sélectionnez l’ID d’appareil IoT Edge dans la liste.
2. Copiez la valeur de Chaîne de connexion principale ou Chaîne de connexion secondaire.

Tous les appareils qui se connectent à votre hub IoT sont listés dans la section Azure IoT Hub de l’Explorateur Visual Studio Code. Les appareils IoT Edge se distinguent des appareils non Edge par leur icône et par le fait que les modules $edgeAgent et $edgeHub sont développés sur chacun d’eux.

Pour configurer votre appareil, vous avez besoin de la chaîne de connexion qui établit un lien entre votre appareil physique et son identité dans le hub IoT.

1. Cliquez avec le bouton droit sur l’ID de votre appareil dans la section Azure IoT Hub.

2. Sélectionnez Copier la chaîne de connexion de l’appareil.

   La chaîne de connexion est copiée dans le Presse-papiers.

Vous pouvez également sélectionner Obtenir les informations de l’appareil dans le menu contextuel pour voir les informations de l’appareil, notamment la chaîne de connexion, dans la fenêtre de sortie.

Utilisez la commande az iot hub device-identity list pour voir tous les appareils dans votre hub IoT. Par exemple :

az iot hub device-identity list --hub-name hub_name_here

Tout appareil inscrit en tant qu’appareil IoT Edge a la propriété capabilities.iotEdge définie sur true.

Pour configurer votre appareil, vous avez besoin de la chaîne de connexion qui établit un lien entre votre appareil physique et son identité dans le hub IoT. Utilisez la commande az iot hub device-identity connection-string show pour retourner la chaîne de connexion d’un appareil unique :

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

La valeur du paramètre device-id respecte la casse.

Quand vous copiez la chaîne de connexion à utiliser sur un appareil, n’incluez pas les guillemets autour de la chaîne de connexion.

Installez IoT Edge pour Linux sur Windows sur votre appareil cible.

1. Dans une session PowerShell avec élévation de privilèges, exécutez chacune des commandes suivantes pour télécharger IoT Edge pour Linux sur Windows.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

2. Installez IoT Edge pour Linux sur Windows sur votre appareil.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Vous pouvez spécifier des répertoires personnalisés d’installation d’IoT Edge pour Linux sur Windows et VHDX en ajoutant les paramètres INSTALLDIR="<FULLY_QUALIFIED_PATH>" et VHDXDIR="<FULLY_QUALIFIED_PATH>" à la commande d’installation. Par exemple, si vous souhaitez utiliser le dossier D:\EFLOW pour l’installation et D:\EFLOW-VHDX pour le VHDX, vous pouvez utiliser l’applet de commande PowerShell suivante.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Définissez la stratégie d’exécution sur l’appareil cible sur AllSigned si ce n’est pas déjà fait. Consultez la configuration requise des commandes PowerShell pour vérifier la stratégie d’exécution actuelle et définir la stratégie d’exécution sur AllSigned.

4. Créer le déploiement d’IoT Edge pour Linux sur Windows. Le déploiement crée votre machine virtuelle Linux et installe le runtime IoT Edge pour vous.

   Deploy-Eflow
   

   Conseil

   Par défaut, la commande Deploy-Eflow crée votre machine virtuelle Linux avec 1 Go de RAM, 1 noyau de processeur virtuel et 16 Go d’espace disque. Toutefois, les ressources dont votre machine virtuelle a besoin dépendent fortement des charges de travail que vous déployez. Si votre machine virtuelle ne dispose pas de suffisamment de mémoire pour prendre en charge vos charges de travail, elle ne démarrera pas.

   Vous pouvez personnaliser les ressources disponibles de la machine virtuelle à l’aide des paramètres facultatifs de la commande Deploy-Eflow.

   Par exemple, la commande ci-dessous crée une machine virtuelle avec 4 cœurs de processeur virtuel, 4 Go de RAM (quantité représentée en Mo) et 20 Go d’espace disque :

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   Pour plus d’informations sur tous les paramètres facultatifs disponibles, consultez Fonctions PowerShell pour IoT Edge pour Linux sur Windows.

   Avertissement

   Par défaut, la machine virtuelle Linux EFLOW n’a pas de configuration DNS. Les déploiements utilisant DHCP essaient d’obtenir la configuration DNS propagée par le serveur DHCP. Vérifiez votre configuration DNS pour garantir la connectivité Internet. Pour plus d’informations, consultez AzEFLOW-DNS.

   Vous pouvez affecter un GPU à votre déploiement pour permettre l’utilisation de modules Linux avec accélération GPU. Pour accéder à ces fonctionnalités, vous devez installer les composants requis détaillés dans Accélération GPU pour Azure IoT Edge pour Linux sur Windows.

   Pour utiliser un relais GPU, ajoutez les paramètres gpuName, gpuPassthroughType et gpuCount à votre commande Deploy-Eflow. Pour plus d’informations sur tous les paramètres facultatifs disponibles, consultez Fonctions PowerShell pour IoT Edge pour Linux sur Windows.

   Avertissement

   L’activation du relais d’appareils matériels peut augmenter les risques liés à la sécurité. Microsoft vous recommande de recourir à un pilote d’atténuation des appareils du fournisseur de votre GPU, le cas échéant. Pour plus d’informations, consultez Déploiement d’appareils graphiques avec la technologie DDA (Discrete Device Assignment).

5. Entrez « Y » pour accepter les termes du contrat de licence.

6. Entrez « O » ou « R » pour activer ou désactiver les données de diagnostic facultatives à votre convenance.

7. Une fois le déploiement terminé, la fenêtre PowerShell signale Déploiement réussi.

   

   Une fois le déploiement réussi, vous êtes prêt à provisionner votre appareil.

1. Installez et ouvrez Windows Admin Center.

   Sur la page d’accueil de Windows Admin Center, sous la liste des connexions figure une connexion d’hôte local qui représente le PC sur lequel Windows Admin Center est exécuté. Les autres serveurs, ordinateurs ou clusters que vous gérez s’affichent également ici.

   Vous pouvez utiliser Windows Admin Center pour gérer Azure IoT Edge pour Linux sur Windows sur votre appareil local ou sur des appareils gérés distants. Dans ce guide, la connexion de l’hôte local servira d’appareil cible pour le déploiement d’Azure IoT Edge pour Linux sur Windows.

2. Vérifiez que votre appareil local est répertorié sous Toutes les connexions, comme indiqué ci-dessous.

   

   Si vous préférez effectuer un déploiement sur un appareil cible distant plutôt que sur votre appareil local, et que l’appareil cible souhaité ne figure pas dans la liste, suivez les instructions pour ajouter votre appareil.

3. Sélectionnez + Ajouter pour commencer à créer votre déploiement. Le déploiement crée votre machine virtuelle Linux et installe le runtime IoT Edge pour vous.

4. Dans le volet Ajouter ou créer des ressources, localisez la vignette Azure IoT Edge. Sélectionnez Créer pour installer une nouvelle instance d’Azure IoT Edge pour Linux sur un appareil.

   Si IoT Edge pour Linux sur Windows est déjà exécuté sur un appareil, vous pouvez sélectionner Ajouter pour vous connecter à cet appareil IoT Edge existant et le gérer avec Windows Admin Center.

   

5. Le volet Créer un déploiement d’Azure IoT Edge pour Linux sur Windows s’ouvre. Sur l’onglet 1. Prise en main, vérifiez la configuration minimale requise, puis sélectionnez Suivant.

6. Passez en revue les termes du contrat de licence, cochez la case J’accepte et sélectionnez Suivant.

7. Vous pouvez activer ou désactiver les données de diagnostic facultatives à votre convenance.

8. Sélectionnez Suivant : Déployer.

   

9. Sur le 2. Onglet Déployer , sous Sélectionner un appareil cible, cliquez sur votre appareil répertorié pour valider qu’il répond aux exigences minimales. Lorsque son état indique qu’il est pris en charge, sélectionnez Suivant.

   

10. Sous l’onglet Paramètres 2.2, vérifiez les paramètres de configuration de votre déploiement. Le tableau ci-dessous présente les paramètres et leurs valeurs par défaut.

    Paramètre	Valeur par défaut
    Taille du disque virtuel en Go	16
    Mémoire en Mo (nombre pair)	1 024
    Nombre de mémoires à tores magnétiques	2
    Version Azure IoT Edge	1.1 (LTS)

    Remarque

    IoT Edge pour Linux sur Windows utilise un commutateur par défaut qui attribue une adresse IP interne à la machine virtuelle Linux. Cette adresse IP interne ne peut pas être atteinte en dehors de l’ordinateur Windows. Vous pouvez vous connecter en local à la machine virtuelle tout en ayant une session ouverte sur l’ordinateur Windows.

    Si vous utilisez Windows Server, configurez un commutateur par défaut avant de déployer IoT Edge pour Linux sur Windows.

    Vous pouvez affecter un GPU à votre déploiement pour permettre l’utilisation de modules Linux avec accélération GPU. Pour accéder à ces fonctionnalités, vous devez installer les composants requis détaillés dans Accélération GPU pour Azure IoT Edge pour Linux sur Windows. Si vous n’installez ces composants requis qu’à ce stade du processus de déploiement, vous devez recommencer du début.

    Deux options sont disponibles pour le relais GPU disponible : Direct Device Assignment (DDA) et GPU Paravirtualization (GPU-PV), en fonction de l’adaptateur GPU attribué au déploiement.

    Pour la méthode DDA, sélectionnez le nombre de processeurs GPU à allouer à votre machine virtuelle Linux.

    Pour la méthode PV, aucun paramètre supplémentaire n’est nécessaire.

    Avertissement

    L’activation du relais d’appareils matériels peut augmenter les risques liés à la sécurité. Microsoft vous recommande de recourir à un pilote d’atténuation des appareils du fournisseur de votre GPU, le cas échéant. Pour plus d’informations, consultez Déploiement d’appareils graphiques avec la technologie DDA (Discrete Device Assignment).

    Une fois que vous êtes satisfait des paramètres, sélectionnez Suivant.

11. Dans l’onglet 2.3. Déploiement, vous pouvez suivre la progression du déploiement. Le processus complet comprend le téléchargement du package Azure IoT Edge pour Linux sur Windows, l’installation du package, la configuration de l’appareil hôte et la configuration de la machine virtuelle Linux. Ce processus peut prendre plusieurs minutes. Voici l’illustration d’un déploiement réussi.

    

12. Une fois votre déploiement terminé, vous êtes prêt à approvisionner votre appareil. Sélectionnez Suivant : Connectez-vous pour passer au 3. Onglet Connexion , qui gère l’approvisionnement d’appareils Azure IoT Edge.

Exécutez la commande suivante dans une session PowerShell avec élévation de privilèges sur votre appareil cible. Remplacez le texte de l’espace réservé par vos propres valeurs.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Pour plus d’informations sur la commande Provision-EflowVM, consultez Fonctions PowerShell pour IoT Edge pour Linux sur Windows.

1. Dans le volet Approvisionnement de l’appareil Azure IoT Edge, sélectionnez Chaîne de connexion (manuel) dans le menu déroulant des méthodes d’approvisionnement.

2. Indiquez la Chaîne de connexion d’appareil que vous avez récupérée sur IoT Hub après avoir inscrit l’appareil.

3. Sélectionnez Provisionnement avec la méthode sélectionnée.

   

4. Une fois l’approvisionnement terminé, sélectionnez Terminer. Vous êtes redirigé vers le tableau de bord principal. Un nouvel appareil, dont le type est IoT Edge Devices, apparaît maintenant dans la liste. Vous pouvez sélectionner l’appareil IoT Edge pour vous y connecter. Une fois sur la page de vue d’ensemble, vous pouvez consulter la liste des modules IoT Edge et l’état IoT Edge de votre appareil.

1. Connectez-vous à votre IoT Edge pour Linux sur machine virtuelle Windows en utilisant la commande suivante dans votre session PowerShell :

   Connect-EflowVm
   

   Notes

   Le seul compte autorisé à accéder via SSH à la machine virtuelle est celui de l’utilisateur qui l’a créée.

2. Une fois connecté, vous pouvez vérifier la liste des modules IoT Edge en cours d’exécution à l’aide de la commande Linux suivante :

   sudo iotedge list
   

3. Si vous devez dépanner le service IoT Edge, utilisez les commandes Linux suivantes.

   1. Récupérez les journaux de service.

      sudo journalctl -u iotedge
      

   2. Utilisez l’outil check pour vérifier l’état de la configuration et de la connexion de l’appareil.

      sudo iotedge check
      

   Remarque

   Sur un appareil nouvellement approvisionné, vous pourriez voir une erreur liée à IoT Edge Hub :

   Vérification de disponibilité de la production × : le répertoire de stockage Edge Hub est conservé sur le système de fichiers hôte - Erreur

   Impossible de vérifier l’état actuel du conteneur edgeHub

   Cette erreur est attendue sur un appareil nouvellement provisionné, car le module IoT Edge Hub n’est pas en cours d’exécution. Pour résoudre l’erreur, dans IoT Hub, définissez les modules de l’appareil et créez un déploiement. La création d’un déploiement pour l’appareil démarre les modules sur l’appareil, y compris le module IoT Edge Hub.

1. Sélectionnez votre appareil IoT Edge dans la liste des appareils connectés dans Windows Admin Center pour vous y connecter.

2. La page de vue d’ensemble de l’appareil affiche des informations sur l’appareil :

   • La section Liste des modules IoT Edge affiche les modules en cours d’exécution sur l’appareil. Lors du premier démarrage du service IoT Edge, seul le module edgeAgent apparaît dans cette liste. Le module edgeAgent s’exécute par défaut et vous aide à installer et démarrer tous les modules supplémentaires que vous déployez sur votre appareil.

   • La section État IoT Edge indique l’état du service, qui doit être actif (en cours d’exécution).