Déployer des modules Azure IoT Edge à l’aide d’Azure CLI

S’applique à : IoT Edge 1.5

Après avoir créé des modules Azure IoT Edge avec votre logique métier, déployez-les sur vos appareils pour fonctionner à la périphérie. Si plusieurs modules fonctionnent ensemble pour collecter et traiter des données, déployez-les en une seule fois. Déclarez également les règles de routage qui les connectent.

Azure CLI est un outil en ligne de commande multiplateforme open source permettant de gérer des ressources Azure comme IoT Edge. Il vous permet de gérer les ressources Azure IoT Hub, les instances de service d’approvisionnement d’appareils et les hubs liés en dehors de la boîte de dialogue. La nouvelle extension IoT enrichit Azure CLI avec des fonctionnalités telles que la gestion des appareils et les fonctionnalités Complètes d’IoT Edge.

Cet article explique comment créer un manifeste de déploiement JSON et utiliser ce fichier pour envoyer (push) le déploiement vers un appareil IoT Edge. Pour plus d’informations sur la création d’un déploiement ciblant plusieurs appareils en fonction de leurs balises partagées, consultez Déployer et surveiller des modules IoT Edge à grande échelle.

Prérequis

• Un hub IoT dans votre abonnement Azure.

• Un appareil IoT Edge.

  Si vous n’avez pas d’appareil IoT Edge configuré, créez-en un dans une machine virtuelle Azure. Suivez les étapes de l’un des articles de démarrage rapide pour créer un appareil Linux virtuel ou créer un appareil Windows virtuel.

• Azure CLI dans votre environnement. Votre version Azure CLI doit être 2.0.70 ou ultérieure. Utilisez az --version pour vérifier. Cette version prend en charge les commandes d’extension az et utilise le framework de commandes Knack.

• Extension IoT pour Azure CLI

Configurer un manifeste de déploiement

Un manifeste de déploiement est un document JSON qui décrit les modules à déployer, le flux des données entre les modules et les propriétés souhaitées des jumeaux de module. Pour plus d’informations sur le fonctionnement des manifestes de déploiement et leur création, voir comment les modules IoT Edge peuvent être utilisés, configurés et réutilisés.

Pour déployer des modules avec Azure CLI, enregistrez localement le manifeste de déploiement dans un fichier .json. Utilisez le chemin du fichier dans la section suivante pour exécuter la commande et appliquer la configuration à votre appareil.

Voici un manifeste de déploiement de base avec un module comme exemple :

{
  "content": {
    "modulesContent": {
      "$edgeAgent": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "runtime": {
            "type": "docker",
            "settings": {
              "minDockerVersion": "v1.25",
              "loggingOptions": "",
              "registryCredentials": {}
            }
          },
          "systemModules": {
            "edgeAgent": {
              "type": "docker",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-agent:1.5",
                "createOptions": "{}"
              }
            },
            "edgeHub": {
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-hub:1.5",
                "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
              }
            }
          },
          "modules": {
            "SimulatedTemperatureSensor": {
              "version": "1.0",
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
                "createOptions": "{}"
              }
            }
          }
        }
      },
      "$edgeHub": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "routes": {
            "upstream": "FROM /messages/* INTO $upstream"
          },
          "storeAndForwardConfiguration": {
            "timeToLiveSecs": 7200
          }
        }
      },
      "SimulatedTemperatureSensor": {
        "properties.desired": {
          "SendData": true,
          "SendInterval": 5
        }
      }
    }
  }
}

Déployer sur votre appareil

Vous déployez les modules sur votre appareil en appliquant le manifeste de déploiement que vous avez configuré avec les informations des modules.

Remplacez les répertoires par le dossier où vous avez enregistré votre manifeste de déploiement. Si vous avez utilisé un des modèles IoT Edge de Visual Studio Code, utilisez le fichier deployment.json dans le dossier config du répertoire de votre solution, et pas le fichier deployment.template.json.

Pour appliquer la configuration à un appareil IoT Edge, utilisez la commande suivante :

az iot edge set-modules --device-id [device id] --hub-name [hub name] --content [file path]

Le paramètre device-id respecte la casse. Le paramètre content pointe vers le fichier manifeste de déploiement que vous avez enregistré.

Afficher les modules sur votre appareil

Une fois les modules déployés sur votre appareil, vous pouvez les voir tous à l’aide de la commande suivante :

Affichez les modules sur votre appareil IoT Edge :

az iot hub module-identity list --device-id [device id] --hub-name [hub name]

Le paramètre device-id respecte la casse.

Étapes suivantes

Découvrez comment déployer et surveiller des modules IoT Edge à grande échelle.