Mise en route avec les connecteurs Greengrass (console)

Connectez-vous à la console AWS Secrets Manager.

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

Sous Choisir le type de secret, choisissez Autre type de secret.

Sous Spécifier les key/value paires à stocker pour ce secret, dans l'onglet Texte en clair, entrez votre jeton d'authentification Twilio. Supprimez tout le formatage JSON et entrez uniquement la valeur du jeton.

Maintenez aws/secretsmanager cette option sélectionnée pour la clé de chiffrement, puis choisissez Suivant.

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

Ce didacticiel ne nécessite pas de rotation. Choisissez Désactiver la rotation automatique, puis cliquez sur Suivant.

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.

Dans le volet de navigation de la AWS IoT console, sous Gérer, développez les appareils Greengrass, puis choisissez Groupes (V1).

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

Sur la page de configuration du groupe, choisissez l'onglet Ressources, puis faites défiler l'écran jusqu'à la section Secrets. La section Secrets affiche les ressources secrètes appartenant au groupe. Vous pouvez ajouter, modifier et supprimer des ressources secrètes depuis cette section.

Choisissez Ajouter dans la section Secrets.

Sur la page Ajouter une ressource secrète, saisissez le nom MyTwilioAuthToken de la ressource.

Pour le Secret, choisissez Greengrass-. TwilioAuthToken

Dans la section Sélectionner les étiquettes (facultatif), l'étiquette intermédiaire AWSCURRENT représente la dernière version 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.

Sur la page Ajouter un connecteur, choisissez Twilio Notifications.

Choisissez la version .

Dans la section Configuration :

Choisissez Add resource (Ajouter ressource).

À partir de la page de téléchargement du SDK AWS IoT Greengrass Core, téléchargez le SDK AWS IoT Greengrass 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 de votre package de déploiement de fonctions Lambda.

Commencez par créer la fonction Lambda.

1. Dans le Console de gestion AWS, choisissez Services et ouvrez la AWS Lambda console.

2. Choisissez Créer une fonction, puis choisissez Auteur à 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.

   • Pour les autorisations, 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é par AWS IoT Greengrass.

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

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

1. Dans l'onglet Code, sous Source du code, choisissez Télécharger depuis. Dans la liste déroulante, choisissez le fichier .zip.

   

2. Choisissez Télécharger, puis choisissez votre package temp_monitor_python.zip de déploiement. Ensuite, choisissez Enregistrer.

3. Dans l'onglet Code de la fonction, sous Paramètres d'exécution, choisissez Modifier, puis entrez les valeurs suivantes.

   • Pour Runtime, sélectionnez Python 3.7.

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

4. Choisissez Enregistrer.

   Note

   Le bouton Test de la AWS Lambda console ne fonctionne pas avec cette fonction. Le SDK AWS IoT Greengrass Core ne contient pas de modules nécessaires pour exécuter vos fonctions Greengrass Lambda de manière indépendante dans la console. AWS Lambda Ces modules (par exemplegreengrass_common) sont fournis aux fonctions après leur déploiement dans votre cœur Greengrass.

À présent, publiez la première version de votre fonction Lambda et créez un alias pour cette 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. Sur la page de configuration TempMonitor : 1, dans le menu Actions, choisissez Créer un alias.

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

   • Pour Nom, saisissez GG_TempMonitor.

   • Pour Version, choisissez 1.

   Note

   AWS IoT Greengrass ne prend pas en charge les alias Lambda pour les versions $LATEST.

5. Choisissez Créer.

Sur la page de configuration du groupe, choisissez l'onglet Fonctions Lambda.

Dans Mes fonctions Lambda, choisissez Ajouter.

Sur la page Ajouter une fonction Lambda, choisissez TempMonitor votre fonction Lambda.

Pour la version de la fonction Lambda, choisissez Alias : TempMonitor GG_.

Choisissez Ajouter une fonction Lambda.

Sur la page de configuration du groupe, choisissez l'onglet Abonnements, puis choisissez Ajouter un abonnement.

Sur la page Créer un abonnement, configurez la source et la cible comme suit :

1. Pour Type de source, choisissez Fonction Lambda, puis choisissez TempMonitor.

2. Pour Type de cible, choisissez Connector, puis choisissez Twilio Notifications.

Pour le filtre thématique, choisisseztwilio/txt.

Choisissez 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. Pour Type de source, choisissez Service, puis IoT Cloud.

2. Pour Sélectionner une cible, choisissez Fonction Lambda, puis choisissez TempMonitor.

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. Pour Type de source, choisissez Connector, puis choisissez Twilio Notifications.

2. Pour Type de cible, choisissez Service, puis IoT Cloud.

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.

Assurez-vous que le AWS IoT Greengrass noyau fonctionne. 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 indiquée dans le chemin 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, choisissez Déployer.

1. Dans l'onglet Fonctions Lambda, dans la section Fonctions Lambda du système, sélectionnez Détecteur IP, puis sélectionnez Modifier.

2. Dans la boîte de dialogue Modifier les paramètres du détecteur IP, sélectionnez Détecter et remplacer automatiquement les points de terminaison du courtier MQTT.

3. Choisissez 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 elle prend AWS IoT Greengrass é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é, accordez l'autorisation de créer le rôle de service Greengrass et associez-le Compte AWS à votre rôle actuel Région AWS. Ce rôle permet d'accéder AWS IoT Greengrass à vos ressources dans les AWS services.

   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 être Terminé.

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

Sur la page d'accueil de la AWS IoT console, choisissez Tester.

Pour S'abonner à la rubrique, utilisez les valeurs suivantes, puis choisissez S'abonner. Le connecteur Twilio Notifications publie des informations d'état dans cette rubrique.

Pour Publier dans la rubrique, utilisez les valeurs suivantes, puis choisissez Publier pour 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. Comme ce chiffre est inférieur à 30, la TempMonitor fonction ne déclenche pas de message Twilio.