Créer et approvisionner des IoT Edge pour Linux sur des appareils Windows à grande échelle à l’aide de clés symétriques

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.

Créer une inscription individuelle dans le service Device Provisioning

1. Dans le Portail Azure, accédez à votre instance du service IoT Hub Device Provisioning.

2. Sous Paramètres, sélectionnez Gérer les inscriptions.

3. Sélectionnez Ajouter une inscription individuelle et suivez ces étapes pour configurer l’inscription :

   1. Pour Mécanisme, sélectionnez Clé symétrique.

   2. Indiquez un ID d’inscription unique pour votre appareil.

   3. Fournissez si vous le souhaitez un ID d’appareil loT Hub pour votre appareil. Vous pouvez utiliser l’ID d’appareil pour cibler un appareil individuel lors du déploiement de module. Si vous ne fournissez pas un ID d’appareil, l’ID d’inscription est utilisé.

   4. Sélectionnez Vrai pour déclarer que cette inscription est un appareil IoT Edge.

   5. Si vous le souhaitez, ajoutez une valeur de balise à l’état initial du jumeau d’appareil. Vous pouvez utiliser des balises pour cibler des groupes d’appareils lors du déploiement de module. Par exemple :

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Sélectionnez Enregistrer.

4. Copiez la clé primaire de l’inscription spécifique à utiliser lors de l’installation du runtime IoT Edge.

Maintenant qu’une inscription existe pour cet appareil, le runtime IoT Edge peut provisionner automatiquement l’appareil lors de l’installation.

Créer une inscription de groupe dans le service Device Provisioning

1. Dans le Portail Azure, accédez à votre instance du service IoT Hub Device Provisioning.

2. Sous Paramètres, sélectionnez Gérer les inscriptions.

3. Sélectionnez Ajouter une inscription individuelle et suivez ces étapes pour configurer l’inscription :

   1. Indiquez un nom de groupe.

   2. Sélectionnez Clé symétrique comme type d’attestation.

   3. Sélectionnez Vrai pour déclarer que cette inscription est un appareil IoT Edge. Pour une inscription de groupe, tous les appareils doivent être de IoT Edge, ou aucun d’entre eux ne peut l’être.

   4. Si vous le souhaitez, ajoutez une valeur de balise à l’état initial du jumeau d’appareil. Vous pouvez utiliser des balises pour cibler des groupes d’appareils lors du déploiement de module. Par exemple :

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Sélectionnez Enregistrer.

4. Copiez la valeur de clé primaire du groupe d’inscriptions à utiliser lors de la création de clés d’appareil à utiliser avec une inscription de groupe.

Maintenant qu’il existe un groupe d’inscriptions, le runtime IoT Edge peut provisionner automatiquement des appareils lors de l’installation.

Dériver une clé d’appareil

Chaque appareil provisionné dans le cadre d’une inscription de groupe a besoin d’une clé d’appareil dérivée pour effectuer une attestation de clé symétrique avec l’inscription lors du provisionnement.

Pour générer une clé d’appareil, utilisez la clé que vous avez copiée à partir de votre groupe d’inscriptions DPS pour calculer un HMAC-SHA256 de l’ID d’inscription unique pour l’appareil et convertir le résultat au format Base64.

Sur Windows, vous pouvez utiliser PowerShell pour générer votre clé d’appareil dérivée, comme indiqué dans l’exemple suivant.

Remplacez la valeur KEY par la clé primaire que vous avez notée précédemment.

Remplacez la valeur de REG_ID avec l’ID d’inscription de votre appareil.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Voici un exemple de sortie d’une clé d’appareil dérivée :

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

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.

Pour PowerShell, exécutez la commande suivante en mettant à jour les valeurs d’espace réservé avec vos propres valeurs :

Provision-EflowVm -provisioningType DpsSymmetricKey -​scopeId PASTE_YOUR_ID_SCOPE_HERE -registrationId PASTE_YOUR_REGISTRATION_ID_HERE -symmKey PASTE_YOUR_PRIMARY_KEY_OR_DERIVED_KEY_HERE

Pour Windows Admin Center, procédez comme suit :

1. Dans le volet Approvisionnement de l’appareil Azure IoT Edge, sélectionnez Clés symétriques (DPS) dans le menu déroulant des méthodes d’approvisionnement.

2. Dans le portail Azure, accédez à votre instance DPS.

3. Indiquez votre ID d’étendue DPS, l’ID d’inscription de l’appareil et la clé primaire ou la clé dérivée de l’inscription dans les champs Windows Admin Center.

4. Sélectionnez Approvisionnement avec la méthode sélectionnée.

   

5. 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, doit maintenant apparaître 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.

Vous pouvez vérifier que l’inscription individuelle que vous avez créée dans le service DPS a bien été utilisée. Accédez à l’instance DPS sur le Portail Azure. Ouvrez les détails de l’inscription pour l’inscription individuelle que vous avez créée. Notez que l’état de l’inscription est Affecté et que l’ID de l’appareil figure dans la liste.

Vous pouvez vérifier que l’inscription de groupe que vous avez créée dans le service DPS a bien été utilisée. Accédez à l’instance DPS sur le Portail Azure. Ouvrez les détails de l’inscription de groupe que vous avez créée. Accédez à l’onglet Enregistrements d’inscription pour afficher tous les appareils enregistrés dans ce groupe.

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).