Propriétés des jumeaux de module de l’agent IoT Edge et du hub IoT Edge
S’applique à :
IoT Edge 1.4
Important
IoT Edge 1.4 est la version prise en charge. Si vous utilisez une version antérieure, consultez l’article Mettre à jour IoT Edge.
L’agent IoT Edge et le hub IoT Edge sont les deux modules qui constituent le runtime IoT Edge. Pour plus d’informations sur les responsabilités de chaque module de runtime, voir Présentation du runtime Azure IoT Edge et de son architecture.
Cet article fournit les propriétés souhaitées et signalées des jumeaux de module du runtime. Pour plus d’informations sur le déploiement de modules sur des appareils IoT Edge, consultez Déployer des modules et établir des itinéraires dans IoT Edge.
Un jumeau de module inclut les éléments suivants :
Propriétés souhaitées (Desired) . Le backend de solution peut définir les propriétés souhaitées, et le module peut les lire. Le module peut également recevoir des notifications sur les changements des propriétés souhaitées. Les propriétés souhaitées sont utilisées en même temps que les propriétés signalées pour synchroniser une configuration ou une condition de module.
Propriétés signalées (Reported) . Le module peut définir les propriétés signalées, et le backend de solution peut les lire et les interroger. Les propriétés signalées sont utilisées en même temps que les propriétés souhaitées pour synchroniser une configuration ou une condition de module.
Propriétés souhaitées pour EdgeAgent
Le jumeau de module de l’agent IoT Edge est appelé $edgeAgent et coordonne les communications entre l’agent IoT Edge exécuté sur un appareil et IoT Hub. Les propriétés souhaitées sont définies lors de l’application d’un manifeste de déploiement sur un appareil spécifique dans le cadre d’un déploiement d’appareil unique ou à grande échelle.
| Propriété | Description | Obligatoire |
|---|---|---|
| imagePullPolicy | Quand extraire l’image dans OnCreate ou Never (Jamais peut être utilisé si l’image est déjà sur l’appareil) | Oui |
| restartPolicy | Lorsque le module doit être redémarré. Les valeurs possibles sont : Jamais : ne redémarrez pas le module s’il n’est pas en cours d’exécution, Toujours redémarrer le module s’il n’est pas en cours d’exécution, On-Unhealthy : redémarrer le module s’il n’est pas sain. Non sain est ce que Docker signale en fonction d’une case activée d’intégrité, par exemple « Non sain - le conteneur ne fonctionne pas correctement », échec : redémarrage en cas d’échec. | Oui |
| runtime.type | Doit être docker. | Oui |
| runtime.settings.minDockerVersion | Défini sur la version Docker minimale demandée par ce manifeste de déploiement. | Oui |
| runtime.settings.loggingOptions | JSON converti en chaînes et contenant les options de journalisation du conteneur d’agent IoT Edge. Options de journalisation Docker | Non |
| runtime.settings.registryCredentials.{registryId}.username | Nom d’utilisateur du registre de conteneurs. Pour Azure Container Registry, le nom d’utilisateur est généralement le nom du registre. Les informations d’identification du Registre sont nécessaires pour toutes les images de module privé. | Non |
| runtime.settings.registryCredentials.{registryId}.password | Mot de passe du registre de conteneurs. | Non |
| runtime.settings.registryCredentials.{registryId}.address | Adresse du registre de conteneurs. Pour Azure Container Registry, l’adresse est généralement {nom du registre}.azurecr.io. | Non |
| schemaVersion | 1.0 ou 1.1. La version 1.1 a été introduite avec IoT Edge version 1.0.10, et est celle recommandée. | Oui |
| statut | État souhaité du module : En cours d’exécution ou arrêté. | Requis |
| systemModules.edgeAgent.type | Doit être docker. | Oui |
| systemModules.edgeAgent.startupOrder | Valeur entière de l’emplacement d’un module dans l’ordre de démarrage. Un 0 est premier et entier maximal (4294967295) est le dernier. Si une valeur n’est pas fournie, la valeur par défaut est l’entier maximal. | Non |
| systemModules.edgeAgent.settings.image | URI de l’image de l’agent IoT Edge. Actuellement, l’agent IoT Edge ne peut pas se mettre à jour lui-même. | Oui |
| systemModules.edgeAgent.settings.createOptions | JSON converti en chaînes et contenant les options de création du conteneur d’agent IoT Edge. Options de création Docker | Non |
| systemModules.edgeAgent.configuration.id | ID du déploiement ayant déployé ce module. | IoT Hub définit cette propriété quand le manifeste est appliqué à l’aide d’un déploiement. Ne fait pas partie d’un manifeste de déploiement. |
| systemModules.edgeHub.type | Doit être docker. | Oui |
| systemModules.edgeHub.type | Doit être en cours d’exécution. | Oui |
| systemModules.edgeHub.restartPolicy | Doit être toujours. | Oui |
| systemModules.edgeHub.startupOrder | Valeur entière pour l’emplacement d’un module dans l’ordre de démarrage. Un 0 est premier et entier maximal (4294967295) est le dernier. Si une valeur n’est pas fournie, la valeur par défaut est l’entier maximal. | Non |
| systemModules.edgeHub.settings.image | URI de l’image du hub IoT Edge. | Oui |
| systemModules.edgeHub.settings.createOptions | JSON converti en chaînes et contenant les options de création du conteneur du hub IoT Edge. Options de création Docker | Non |
| systemModules.edgeHub.configuration.id | ID du déploiement ayant déployé ce module. | IoT Hub définit cette propriété quand le manifeste est appliqué à l’aide d’un déploiement. Ne fait pas partie d’un manifeste de déploiement. |
| modules.{moduleId}.version | Chaîne définie par l’utilisateur représentant la version de ce module. | Oui |
| modules.{moduleId}.type | Doit être docker. | Oui |
| modules.{moduleId}.status | {en cours d’exécution | arrêté} | Oui |
| modules.{moduleId}.restartPolicy | {jamais | toujours} | Oui |
| modules.{moduleId}.startupOrder | Valeur entière de l’emplacement d’un module dans l’ordre de démarrage. Un 0 est premier et entier maximal (4294967295) est le dernier. Si une valeur n’est pas fournie, la valeur par défaut est l’entier maximal. | Non |
| modules.{moduleId}.imagePullPolicy | {on-create | never} | Non |
| modules.{moduleId}.env | Liste de variables d’environnement à passer au module. Prend le format "<name>": {"value": "<value>"}. |
Non |
| modules.{moduleId}.settings.image | URI de l’image du module. | Oui |
| modules.{moduleId}.settings.createOptions | Champ de chaîne JSON contenant les options de création du conteneur de module. Options de création Docker | Non |
| modules.{moduleId}.configuration.id | ID du déploiement ayant déployé ce module. | IoT Hub définit cette propriété quand le manifeste est appliqué à l’aide d’un déploiement. Ne fait pas partie d’un manifeste de déploiement. |
| version | Itération actuelle qui a la version, la validation et la génération. | Non |
Propriétés signalées pour EdgeAgent
Les propriétés signalées pour l’agent IoT Edge incluent trois informations principales :
- l’état de l’application de dernières propriétés souhaitées affichées ;
- L’état des modules en cours d’exécution sur l’appareil, comme signalé par l’agent IoT Edge
- une copie des propriétés souhaitées en cours d’exécution sur l’appareil.
La copie des propriétés souhaitées actuelles est utile pour déterminer si l’appareil a appliqué le dernier déploiement ou exécute encore un manifeste de déploiement antérieur.
Remarque
Les propriétés signalées de l’agent IoT Edge sont utiles, car elles peuvent être interrogées avec le langage de requête IoT Hub afin de connaître l’état des déploiements à grande échelle. Pour plus d’informations sur l’utilisation des propriétés de l’agent IoT Edge pour l’état, consultez Comprendre les déploiements IoT Edge pour les appareils uniques ou à grande échelle.
Le tableau suivant n’inclut pas les informations copiées à partir des propriétés souhaitées.
| Propriété | Description |
|---|---|
| lastDesiredStatus.code | Ce code d’état fait référence aux dernières propriétés souhaitées observées par l’agent IoT Edge. Valeurs autorisées : 200 Réussite, 400 Configuration non valide, 412 Version de schéma non valide, 417 Propriétés souhaitées vides, 500 Échec. |
| lastDesiredStatus.description | Texte de description de l’état. |
| lastDesiredVersion | Cet entier référence la dernière version des propriétés souhaitées traitées par l’agent IoT Edge. |
| runtime.platform.OS | Indique le système d’exploitation en cours d’exécution sur l’appareil. |
| runtime.platform.architecture | Indique l’architecture du processeur sur l’appareil. |
| schemaVersion | Version de schéma des propriétés signalées. |
| systemModules.edgeAgent.runtimeStatus | État signalé de l’agent IoT Edge : {exécution | non saine}. |
| systemModules.edgeAgent.statusDescription | Texte de description de l’état signalé de l’agent IoT Edge. |
| systemModules.edgeAgent.exitCode | Code de sortie signalé par le conteneur de l’agent IoT Edge si le conteneur s’arrête. |
| systemModules.edgeAgent.lastStartTimeUtc | Heure à laquelle l’agent IoT Edge a été démarré pour la dernière fois. |
| systemModules.edgeAgent.lastExitTimeUtc | Heure de la dernière sortie de l’agent IoT Edge. |
| systemModules.edgeHub.runtimeStatus | État du hub IoT Edge : { en cours d’exécution | a arrêté l’arrêt | | | non sain }. |
| systemModules.edgeHub.statusDescription | Description textuelle de l’état du hub IoT Edge, s’il n’est pas sain. |
| systemModules.edgeHub.exitCode | Code de sortie signalé par le conteneur hub IoT Edge, si le conteneur se ferme. |
| systemModules.edgeHub.lastStartTimeUtc | Heure du dernier démarrage du hub IoT Edge. |
| systemModules.edgeHub.lastExitTimeUtc | Heure de la dernière sortie du hub IoT Edge. |
| systemModules.edgeHub.lastRestartTimeUtc | Heure du dernier redémarrage du hub IoT Edge. |
| systemModules.edgeHub.restartCount | Nombre de redémarrages de ce module dans le cadre de la stratégie de redémarrage. |
| modules.{moduleId}.runtimeStatus | État du module : { en cours d’exécution | a arrêté | l’arrêt | | non sain }. |
| modules.{moduleId}.statusDescription | Description textuelle de l’état du module, s’il n’est pas sain. |
| modules.{moduleId}.exitCode | Code de sortie signalé par le conteneur de module, si le conteneur se ferme. |
| Modules. {moduleId}.lastStartTimeUtc | Heure du dernier démarrage du module. |
| modules.{moduleId}.lastExitTimeUtc | Heure de la dernière sortie du module. |
| modules.{moduleId}.lastRestartTimeUtc | Heure du dernier redémarrage du module. |
| modules.{moduleId}.restartCount | Nombre de redémarrages de ce module dans le cadre de la stratégie de redémarrage. |
| version | Version de l’image. Exemple : « version » : { « version » : « 1.2.7 », « build » : « 50979330 », « commit » : « d3ec971caa0af0fc39d2c1f91aef21e95bd0c03c » }. |
Propriétés souhaitées pour EdgeHub
Le jumeau de module du hub IoT Edge est appelé $edgeHub et coordonne les communications entre le hub IoT Edge exécuté sur un appareil et IoT Hub. Les propriétés souhaitées sont définies lors de l’application d’un manifeste de déploiement sur un appareil spécifique dans le cadre d’un déploiement d’appareil unique ou à grande échelle.
| Propriété | Description | Requise dans le manifeste de déploiement |
|---|---|---|
| schemaVersion | 1.0 ou 1.1. La version 1.1 a été introduite avec IoT Edge version 1.0.10, et est celle recommandée. | Oui |
| routes.{routeName} | Chaîne représentant la route d’un hub IoT Edge. Pour plus d’informations, consultez Déclarer des itinéraires. | L’élément routes peut être présent mais vide. |
| storeAndForwardConfiguration.timeToLiveSecs | Durée de l’appareil en secondes pendant laquelle le hub IoT Edge conserve les messages en cas de points de terminaison de routage déconnectés, par exemple, déconnectés d’IoT Hub ou d’un module local. Cette durée persiste sur les pannes ou redémarrages. Pour plus d’informations, voir Fonctionnalités hors connexion. | Oui |
Propriétés signalées pour EdgeHub
| Propriété | Description |
|---|---|
| lastDesiredVersion | Cet entier référence la dernière version des propriétés souhaitées traitées par le hub IoT Edge. |
| lastDesiredStatus.code | Ce code d’état fait référence aux dernières propriétés souhaitées observées par le hub IoT Edge. Valeurs autorisées : 200 Réussite, 400 Configuration non valide, 500 Échec |
| lastDesiredStatus.description | Texte de description de l’état. |
| Applications mobiles | Tous les clients connectés à edgeHub avec l’état et la dernière heure connectée. Exemple : « clients » : { « device2/SimulatedTemperatureSensor » : { « status » : « Connecter ed », « last Connecter edTimeUtc » : « 2022-11-17T21 :49 :16.4781564Z » } }. |
| clients.{device or moduleId}.status | État de connectivité de cet appareil ou module. Valeurs possibles {connecté | déconnecté}. Seules les identités de module peuvent être à l’état déconnecté. Les appareils en aval se connectant au hub IoT Edge ne s’affichent que lorsqu’ils sont connectés. |
| clients.{device or moduleId}.lastConnectTime | Dernière connexion de l’appareil ou du module. |
| clients.{device or moduleId}.lastDisconnectTime | Dernière déconnexion de l’appareil ou du module. |
| schemaVersion | Version de schéma des propriétés signalées. |
| version | Version de l’image. Exemple : « version » : { « version » : « 1.2.7 », « build » : « 50979330 », « commit » : « d3ec971caa0af0fc39d2c1f91aef21e95bd0c03c » }. |
Étapes suivantes
Pour savoir comment utiliser ces propriétés pour générer des manifestes de déploiement, consultez Comprendre comment les modules IoT Edge peuvent être utilisés, configurés et réutilisées.