Mise en route avec les connecteurs Greengrass (console)

Connectez-vous à la console AWS Secrets Manager.

Choisissez Store a new secret (Stocker un nouveau secret).

UnderChoisissez le type de secret, choisissezOther type of secret (Autre type de secret).

Sous Spécifiez les paires clé/valeur à être stockées pour ce secret, dans l'onglet Texte brut, saisissez votre jeton d'authentification Twilio. Supprimez tout le formatage JSON et entrez uniquement la valeur du jeton.

Keepaws/secretsmanagersélectionné pour la clé de chiffrement, puis choisissezSuivant.

Pour Secret name, entrez greengrass-TwilioAuthToken et choisissez Next.

Ce didacticiel n'exige pas la rotation. Par conséquent, choisissez Désactiver la rotation automatique, puis choisissezSuivant.

Dans la page Révision, passez en revue vos paramètres, puis choisissez Stocker.

Ensuite, vous créez une ressource de secret dans votre groupe Greengrass qui référence le secret.

DansAWS IoTVolde navigation de la console, sousGérer, développez.Appareils Greengrass, puis choisissezGroups (V1).

Choisissez le groupe auquel vous souhaitez ajouter la ressource de secret.

Sur la page de configuration de groupe, choisissez l'Ressources, puis faites défiler l'écran jusqu'à laSecretsSection. LeSecretsaffiche les ressources de secret qui appartiennent au groupe. Vous pouvez ajouter, modifier et supprimer des ressources de secret à partir de cette section.

ChoisissezAdditionsousSecretsSection.

Dans la pageAjouter une ressource de secretpage, entrezMyTwilioAuthTokenpour laNom de la ressource.

PourSecret, choisissezgreengrassTwilioAuthToken.

DansSélectionnez les étiquettes (facultatif), la section AWSCURRENT Le label de mise en scène représente la version la plus récente du secret. Cette étiquette est toujours incluse dans une ressource de secret.

Choisissez Add resource (Ajouter ressource).

Sur la page de configuration de groupe, choisissez Connecteurs, puis choisissez Ajouter un connecteur.

Dans la pageAjouter un connecteur, choisissezNotifications Twilio.

Choisissez la version .

DansConfigurationSection:

Choisissez Add resource (Ajouter ressource).

De laAWS IoT GreengrassKit SDK Corepage de téléchargement, téléchargez leAWS IoT GreengrassSDK Core pour Python sur votre ordinateur.

Décompressez le package téléchargé pour obtenir le kit SDK. Le kit SDK est représenté par le dossier greengrasssdk.

Enregistrez la fonction de code Python suivante dans un fichier local nommé temp_monitor.py.

import greengrasssdk
import json
import random

client = greengrasssdk.client('iot-data')

# publish to the Twilio Notifications connector through the twilio/txt topic
def function_handler(event, context):
    temp = event['temperature']
    
    # check the temperature
    # if greater than 30C, send a notification
    if temp > 30:
        data = build_request(event)
        client.publish(topic='twilio/txt', payload=json.dumps(data))
        print('published:' + str(data))
        
    print('temperature:' + str(temp))
    return

# build the Twilio request from the input data
def build_request(event):
    to_name = event['to_name']
    to_number = event['to_number']
    temp_report = 'temperature:' + str(event['temperature'])

    return {
        "request": {
            "recipient": {
                "name": to_name,
                "phone_number": to_number,
                "message": temp_report
            }
        },
        "id": "request_" + str(random.randint(1,101))
    }

Compressez les éléments suivants dans un fichier nommé temp_monitor_python.zip. Lorsque vous créez le fichier zip, insérez uniquement le code et ses dépendances, pas le dossier dans lequel il se trouve.

Il s'agit du package de déploiement de votre fonction Lambda.

Créez d'abord la fonction Lambda.

1. Dans AWS Management Console, choisissez Services et ouvrez la console AWS Lambda.

2. ChoisissezCréation de fonctionpuis choisissezCréer à partir de zéro.

3. Dans la section Informations de base, spécifiez les valeurs suivantes :

   • Sous Nom de la fonction, saisissez TempMonitor.

   • Pour Runtime, sélectionnez Python 3.7.

   • PourAutorisations, conservez le paramètre par défaut. Cela crée un rôle d'exécution qui accorde des autorisations Lambda de base. Ce rôle n'est pas utilisé parAWS IoT Greengrass.

4. Dans le bas de la page, choisissez Create function.

Enregistrez ensuite le gestionnaire et téléchargez le package de déploiement de votre fonction Lambda.

1. Dans la pageCodeonglet, sousSource de code, choisissezChargement à partir de. Dans le menu déroulant, choisissezfichier .zip.

   

2. ChoisissezCharger, puis choisissez votretemp_monitor_python.zippackage de déploiement. Ensuite, choisissez Enregistrer.

3. Dans la pageCodepour la fonction, sousParamètres d'exécution, choisissezModifier, puis entrez les valeurs suivantes.

   • Pour Runtime, sélectionnez Python 3.7.

   • Pour Handler (Gestionnaire), entrez temp_monitor.function_handler.

4. Choisissez Save (Enregistrer).

   Note

   LeTestsur la pageAWS Lambdala console ne fonctionne pas avec cette fonction. LeAWS IoT GreengrassLe SDK principal ne contient pas de modules nécessaires pour exécuter vos fonctions Greengrass Lambda indépendamment dans leAWS Lambdaconsole Ces modules (par exemple,greengrass_common) sont fournis aux fonctions après leur déploiement dans votre cœur Greengrass.

Publiez maintenant la première version de votre fonction Lambda et créez unalias pour la version.

1. Dans le menu Actions, sélectionnez Publier une nouvelle version.

2. Dans Description de la version, saisissez First version, puis choisissez Publish.

3. Dans la pageTempMonitor : 1page de configuration, depuis la pageActions, choisissez, choisissezCréer un alias.

4. Sur la page Create a new alias, utilisez les valeurs suivantes :

   • Pour Name (Nom), saisissez GG_TempMonitor.

   • Pour Version, choisissez 1.

   Note

   AWS IoT Greengrassne prend pas en charge les alias Lambda pour$LATESTversions.

5. Sélectionnez Create (Créer).

Sur la page de configuration de groupe, choisissez l'Fonctions LambdaOnglet.

UnderFonctions Lambda, choisissezAddition.

Dans la pageAjouter une fonction Lambda, choisissezTempMonitorpour votre fonction Lambda

PourVersion de la fonction Lambda, choisissezAlias : GG_TempMonitor.

ChoisissezAjouter une fonction Lambda.

Sur la page de configuration de groupe, choisissez l'Subscriptions, puis choisissezAjouter un abonnement.

Dans la pageCréer un abonnement, configurez la source et la cible, comme suit :

1. PourType de source, choisissezFonction Lambda, puis choisissezTempMonitor.

2. PourTarget type (Type de cible), choisissezConnecteur, puis choisissezNotifications Twilio.

PourFiltre de rubriques, choisisseztwilio/txt.

Choisissez Create subscription (Créer un abonnement).

Répétez les étapes 1 à 4 pour créer un abonnement qui permet à AWS IoT de publier des messages dans la fonction.

1. PourType de source, choisissezService, puis choisissezCloud IoT.

2. PourSélectionnez une cible, choisissezFonction Lambda, puis choisissezTempMonitor.

3. Pour Filtre de rubrique, tapez temperature/input.

Répétez les étapes 1 à 4 pour créer un abonnement qui permet au connecteur de publier des messages dans AWS IoT.

1. PourType de source, choisissezConnecteur, puis choisissezNotifications Twilio.

2. PourTarget type (Type de cible), choisissezService, puis choisissezCloud IoT.

3. Pour Topic filter, twilio/message/status est entré pour vous. Il s'agit de la rubrique prédéfinie dans laquelle le connecteur effectue la publication.

Vérifiez les éléments suivants :AWS IoT Greengrasscore est en cours d'exécution. Dans la fenêtre de terminal de votre Raspberry Pi, exécutez les commandes suivantes, si nécessaire.

1. Pour vérifier si le démon est en cours d'exécution :

   ps aux | grep -E 'greengrass.*daemon'

   Si la sortie contient une entrée root pour /greengrass/ggc/packages/ggc-version/bin/daemon, le démon est en cours d'exécution.

   Note

   La version du chemin d'accès dépend de la version du logiciel AWS IoT Greengrass Core installée sur votre appareil principal.

2. Pour démarrer le démon :

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Sur la page de configuration du groupe, choisissezDéploiement.

1. DansFonctions Lambda, sous l'ongletFonctions Lambdasection, sélectionnezDétecteur IPet choisissezModifier.

2. DansModifier les paramètres du détecteur IP, sélectionnezDétecter et remplacer automatiquement les points de terminaison des courtiers MQTT.

3. Choisissez Save (Enregistrer).

   Les appareils peuvent ainsi acquérir automatiquement des informations de connectivité pour le noyau, telles que l'adresse IP, le DNS et le numéro de port. La détection automatique est recommandée, mais AWS IoT Greengrass prend également en charge les points de terminaison spécifiés manuellement. Vous êtes uniquement invité à indiquer la méthode de découverte lors du déploiement initial du groupe.

   Note

   Si vous y êtes invité, autorisez la création deRôle de service Greengrasset associez-le à votreCompte AWSdans les actuelsRégion AWS. Ce rôle permet àAWS IoT Greengrasspour accéder à vos ressources dansAWSServices .

   La page Déploiements indique l'horodatage, l'ID de version et l'état du déploiement. Une fois terminé, le statut affiché pour le déploiement doit afficher l'état du déploiement estTerminé.

   Pour bénéficier d'une aide à la résolution des problèmes, consultez Résolution des problèmes de AWS IoT Greengrass.

Dans la pageAWS IoTpage d'accueil de la console, choisissezTest.

PourS'abonner à la rubrique, utilisez les valeurs suivantes, puis choisissezS'abonner. Le connecteur Twilio Notifications publie des informations de statut dans cette rubrique.

PourPublier dans la rubrique, utilisez les valeurs suivantes, puis choisissezPublierpour appeler la fonction.

{
   "to_name": "recipient-name",
   "to_number": "recipient-phone-number",
   "temperature": 31
}

En cas de réussite, le destinataire reçoit le SMS et la console affiche le statut success depuis les données de sortie.

Maintenant, passez la temperature dans le message d'entrée à 29 et publiez. Étant donné que cette valeur est inférieure à 30, le TempMonitor ne déclenche pas de message Twilio.