AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Intégrer à des services et protocoles à l'aide de connecteurs Greengrass

Cette fonction est disponible uniquement pour lesAWS IoT GreengrassCore v1.7 et version 1.7.

Connecteurs dansAWS IoT Greengrasssont des modules prédéfinis qui rendent plus efficace l'interaction avec l'infrastructure locale, les protocoles de périphérique,AWSet d'autres services cloud. En utilisant des connecteurs, vous pouvez consacrer moins de temps à apprendre des nouveaux protocoles et des API et consacrer plus de temps à lalogiquequi compte pour votre entreprise.

Le schéma suivant montre où les connecteurs peuvent s'intégrer dans le documentAWS IoT Greengrass paysage.

De nombreux connecteurs utilisent des messages MQTT pour communiquer avec les appareils clients et les fonctions Lambda Greengrass du groupe ou avecAWS IoTet le service shadow local. Dans l'exemple suivant, le connecteur Twilio Notifications reçoit des messages MQTT à partir d'une fonction Lambda définie par l'utilisateur, utilise une référence locale d'un secret à partir deAWS Secrets Manageret appelle l'API Twilio.

Pour accéder aux didacticiel permettant de créer cette solution, consultez Mise en route avec les connecteurs Greengrass (console) et Démarrage avec les connecteurs Greengrass (CLI).

Les connecteurs Greengrass peuvent vous aider à développer des fonctionnalités de périphérique ou à créer des appareils à usage unique. À l'aide de connecteurs, vous pouvez :

AWSfournit un ensemble d'exemples de connecteurs Greengrass qui simplifient les interactions avec les services courants et les sources de données. Ces modules réutilisables prédéfinis activent des scénarios pour la journalisation et les diagnostics, le réapprovisionnement, le traitement des données industrielles, l'alarme et la messagerie. Pour plus d'informations, consultez AWS- connecteurs Greengrass fournis.

Prérequis

Pour utiliser des connecteurs, gardez ces points à l'esprit :

Utilisation des connecteurs Greengrass

Connecteur Aest un type de composant de groupe. Comme les autres composants de groupe, tels que les appareils clients et les fonctions Lambda définies par l'utilisateur, vous ajoutez des connecteurs à des groupes, vous configurez leurs paramètres et vous les déployez dans leAWS IoT Greengrasscore. Connecteurs utilisés dans l'environnement principal.

Vous pouvez déployer certains connecteurs en tant que simples applications autonomes. Par exemple, le connecteur Device Defender lit les métriques du système à partir de l'appareil principal et les envoie àAWS IoT Device Defenderpour analyse.

Vous pouvez ajouter d'autres connecteurs en tant que blocs de construction dans des solutions plus volumineuses. La solution de l'exemple suivant utilise le connecteur de l'adaptateur de protocole Modbus-RTU pour traiter les messages à partir de capteurs et le connecteur Twilio Notifications pour déclencher des messages Twilio.

Les solutions incluent souvent les fonctions Lambda définies par l'utilisateur qui restent en regard des connecteurs et traitent les données que le connecteur envoie ou reçoit. Dans cet exemple, le document TempMonitorreçoit des données de Modbus-RTU Protocol Adapter, exécute une logique métier, puis envoie les données à Twilio Notifications.

Pour créer et déployer une solution, vous suivez cette procédure générale :

Pour plus d'informations sur la création et le déploiement d'un connecteur, consultez les didacticiels suivants :

Paramètres de configuration

Beaucoup de connecteurs fournissent des paramètres qui vous permettent de personnaliser le comportement ou la sortie. Ces paramètres sont utilisés lors de l'initialisation, de l'exécution, ou à d'autres moments dans le cycle de vie du connecteur.

Les types de paramètres et leur utilisation varient en fonction du connecteur. Par exemple, le connecteur SNS dispose d'un paramètre qui configure la valeur par défaut de la rubrique SNS et Device Defender dispose d'un paramètre qui configure la fréquence de collecte des données.

Une version de groupe peut contenir plusieurs connecteurs, mais une seule instance d'un connecteur donné à la fois. Cela signifie que chaque connecteur du groupe ne peut avoir qu'une seule configuration active. Cependant, l'instance de connecteur peut être utilisée dans plusieurs abonnements dans le groupe. Par exemple, vous pouvez créer des abonnements qui autorisent de nombreux appareils à envoyer des données au connecteur Kinesis Firehose.

Paramètres utilisés pour accéder aux ressources d'un groupe

Les connecteurs Greengrass utilisent des ressources de groupe pour accéder au système de fichiers, aux ports, aux périphériques et aux autres ressources locales sur l'appareil principal. Si un connecteur nécessite l'accès à une ressource de groupe, il fournit alors des paramètres de configuration associés.

Les ressources de groupe comprennent :

Par exemple, les paramètres de Device Defender autorisent l'accès aux métriques du système sur l'hôte./procet les paramètres des notifications Twilio de activent l'accès à un jeton d'authentification Twilio stocké localement.

Mise à jour des paramètres du connecteur

Les paramètres sont configurés lorsque le connecteur est ajouté à un groupe Greengrass. Vous pouvez modifier les valeurs des paramètres après l'ajout du connecteur.

Lorsque vous apportez des modifications à la configuration du connecteur, vous devez déployer le groupe pour propager les modifications au noyau.

Entrées et sorties

De nombreux connecteurs Greengrass peuvent communiquer avec d'autres entités par l'envoi et la réception de messages MQTT. Cette communication est contrôlée par les abonnements qui permettent à un connecteur d'échanger des données avec des fonctions Lambda, des appareils clients et d'autres connecteurs du groupe Greengrass, ou avecAWS IoTet le service shadow local. Pour autoriser cette communication, vous devez créer des abonnements dans le groupe auquel le connecteur appartient. Pour plus d'informations, consultez Abonnements gérés dans le flux de travail de messagerie MQTT.

Les connecteurs peuvent être des abonnés aux messages, des éditeurs de messages ou les deux. Chaque connecteur définit les rubriques MQTT qu'il publie ou auquel il s'abonne. Ces rubriques prédéfinies doivent être utilisées dans les abonnements où le connecteur est une source ou une cible de message. Pour les didacticiels qui incluent des étapes pour la configuration d'abonnements d'un connecteur, consultez Mise en route avec les connecteurs Greengrass (console) et Démarrage avec les connecteurs Greengrass (CLI).

Rubriques d'entrée

La plupart des connecteurs reçoivent des données en entrée sur les rubriques MQTT. Certains connecteurs s'abonnent à plusieurs rubriques pour les données d'entrée. Par exemple, le connecteur Serial Stream prend en charge deux rubriques :

Pour ce connecteur, les demandes de lecture et écriture sont envoyées à la rubrique correspondante. Lorsque vous créez des abonnements, assurez-vous d'utiliser la rubrique qui correspond à votre implémentation.

Les caractères + et # des exemples précédents sont des caractères génériques. Ces caractères génériques autorisent les abonnés à recevoir des messages sur plusieurs rubriques et les éditeurs à personnaliser les rubriques dans lesquelles ils publient.

Les caractères génériques sont valides uniquement lorsque vous vous abonnez à des rubriques. Les messages ne peuvent pas être publiés dans des rubriques qui contiennent des caractères génériques. Vérifiez la documentation du connecteur pour plus d'informations sur ses exigences de rubriques d'entrée ou de sortie. Pour plus d'informations, consultez AWS- connecteurs Greengrass fournis.

Prise en charge de la conteneurisation

Par défaut, la plupart des connecteurs s'exécutent sur le noyau Greengrass dans un environnement d'exécution isolé géré par AWS IoT Greengrass. Ces environnements d'exécution, appelés conteneurs, assurent l'isolement entre les connecteurs et le système hôte, ce qui offre plus de sécurité pour l'hôte et le connecteur.

Cependant, cette conteneurisation Greengrass n'est pas prise en charge dans certains environnements, par exemple en cas d'exécution deAWS IoT Greengrassdans un conteneur Docker ou sur des noyaux Linux plus anciens sans cgroups. Dans ces environnements, les connecteurs doivent s'exécuter en mode Aucun conteneur. Pour rechercher des connecteurs prenant en charge le mode No container (Aucun conteneur) veuillez consulter AWS- connecteurs Greengrass fournis. Certains connecteurs s'exécutent en mode natif et certains connecteurs vous permettent de définir le mode d'isolement.

Vous pouvez également définir le mode d'isolement sur Aucun conteneur dans les environnements prenant en charge la conteneurisation Greengrass, mais nous vous recommandons d'utiliser le mode conteneur Greengrass lorsque cela est possible.

Mise à niveau des versions du connecteur

Les fournisseurs de connecteurs peuvent publier de nouvelles versions d'un connecteur qui ajoutent des fonctions, corrigent des problèmes ou améliorent les performances. Pour de plus amples informations sur les versions disponibles et les modifications associées, veuillez consulter la documentation de chaque connecteur.

DansAWS IoT, vous pouvez rechercher de nouvelles versions pour les connecteurs de votre groupe Greengrass.

Pour mettre à niveau un connecteur à partir de l'API AWS IoT Greengrass, créez et déployez une version de groupe qui inclut le connecteur mis à jour et les abonnements. Utilisez le même processus que lorsque vous ajoutez un connecteur à un groupe. Pour obtenir des instructions détaillées qui vous montrent comment utiliser le documentAWS CLIpour configurer et déployer un exemple de connecteur Twilio Notifications, consultezDémarrage avec les connecteurs Greengrass (CLI).

Journalisation des connecteurs

Les connecteurs Greengrass contiennent des fonctions Lambda qui écrivent des événements et des erreurs dans les journaux Greengrass. En fonction des paramètres de votre groupe, les journaux sont écrits dans CloudWatch Les journaux, le système de fichiers local, ou les deux. Les journaux des connecteurs incluent l'ARN de la fonction correspondante. L'ARN dans l'exemple suivant constitue la réponse ARN du connecteur Kinesis Firehose :

arn:aws:lambda:aws-region:account-id:function:KinesisFirehoseClient:1

Par défaut, la configuration de la journalisation écrit des journaux de niveau information dans le système de fichiers à l'aide de la structure de répertoire suivante :

greengrass-root/ggc/var/log/user/region/aws/function-name.log

Pour plus d'informations sur la journalisation Greengrass, consultezSurveillance avec les journaux AWS IoT Greengrass.