Comment configurer l'accès aux ressources locales à l'aide du Console de gestion AWS

Sur votre ordinateur, copiez le script Python suivant dans un fichier local nommé lraTest.py. Il s'agit de la logique de l'application pour la fonction Lambda.

# Demonstrates a simple use case of local resource access.
# This Lambda function writes a file test to a volume mounted inside
# the Lambda environment under destLRAtest. Then it reads the file and 
# publishes the content to the AWS IoT LRAtest topic. 

import sys
import greengrasssdk
import platform
import os
import logging

# Setup logging to stdout
logger = logging.getLogger(__name__)
logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)

# Create a Greengrass Core SDK client.
client = greengrasssdk.client('iot-data')
volumePath = '/dest/LRAtest'

def function_handler(event, context):
    try:
        client.publish(topic='LRA/test', payload='Sent from AWS IoT Greengrass Core.')
        volumeInfo = os.stat(volumePath)
        client.publish(topic='LRA/test', payload=str(volumeInfo))
        with open(volumePath + '/test', 'a') as output:
            output.write('Successfully write to a file.')
        with open(volumePath + '/test', 'r') as myfile:
            data = myfile.read()
        client.publish(topic='LRA/test', payload=data)
    except Exception as e:
        logger.error('Failed to publish message: ' + repr(e))
    return

À 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.

Compressez les éléments suivants dans un fichier nommé lraTestLambda.zip :

Le lraTestLambda.zip fichier est le package de déploiement de votre fonction Lambda. Vous êtes maintenant prêt à créer une fonction Lambda et à charger le package de déploiement.

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

Choisissez Fonctions.

Choisissez Créer une fonction, puis choisissez Auteur à partir de zéro.

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

1. Sous Nom de la fonction, saisissez TestLRA.

2. Pour Runtime, sélectionnez Python 3.7.

3. 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.

Choisissez Créer une fonction.

Téléchargez votre package de déploiement de fonction Lambda et enregistrez le gestionnaire.

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 lraTestLambda.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, saisissez lra Test.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.

Publiez ensuite la première version de votre fonction Lambda. Puis, créez un alias pour la version.

Les groupes Greengrass peuvent référencer une fonction Lambda par alias (recommandé) ou par version. L'utilisation d'un alias facilite la gestion des mises à jour de code, car vous n'avez pas à modifier votre table d'abonnement ou votre définition de groupe lorsque le code de fonction est mis à jour. Au lieu de cela, il vous suffit de pointer l'alias vers la nouvelle version de la fonction.

Dans Actions, choisissez Publier une nouvelle version.

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

Sur la page de configuration TestLRA: 1, dans le menu Actions, choisissez Create alias (Créer un alias).

Sur la page Créer un alias, dans le champ Nom, saisisseztest. Pour Version, entrez 1.

Choisissez Créer.

Vous pouvez désormais ajouter la fonction Lambda à votre groupe Greengrass.

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 Greengrass dans lequel vous souhaitez ajouter la fonction Lambda.

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

Dans la section Mes fonctions Lambda, choisissez Ajouter.

Sur la page Ajouter une fonction Lambda, choisissez la fonction Lambda. Sélectionnez TestLRA.

Choisissez la version de la fonction Lambda.

Dans la section Configuration de la fonction Lambda, sélectionnez Utilisateur et groupe du système et Conteneurisation de la fonction Lambda.

Configurez ensuite le cycle de vie de la fonction Lambda.

Pour Timeout (Délai), sélectionnez 30 secondes.

Au bas de la page, choisissez Ajouter une fonction Lambda.

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

Dans la section Ressources locales, choisissez Ajouter.

Sur la page Ajouter une ressource locale, utilisez les valeurs suivantes.

1. Sous Resource Name (Nom de la ressource), entrez testDirectory.

2. Pour Type de ressource, choisissez Volume.

3. Dans le champ Local device path, entrez/src/LRAtest. (Ce chemin doit exister sur le système d'exploitation hôte.)

   Le chemin du périphérique local est le chemin absolu local de la ressource sur le système de fichiers du périphérique principal. Cet emplacement est en dehors du conteneur dans lequel la fonction s'exécute. Le chemin ne peut pas commencer par /sys.

4. Pour Destination path (Chemin d'accès de destination), entrez /dest/LRAtest. (Ce chemin doit exister sur le système d'exploitation hôte.)

   Le chemin de destination est le chemin absolu de la ressource dans l'espace de noms Lambda. Cet emplacement est dans le conteneur dans lequel la fonction s'exécute.

5. Sous Propriétaire du groupe système et autorisation d'accès aux fichiers, sélectionnez Ajouter automatiquement les autorisations de système de fichiers du groupe système propriétaire de la ressource.

   L'option Propriétaire du groupe système et autorisation d'accès aux fichiers vous permet d'accorder des autorisations d'accès aux fichiers supplémentaires au processus Lambda. Pour de plus amples informations, veuillez consulter Autorisation d'accès fichier pour le propriétaire du groupe.

Choisissez Add resource (Ajouter ressource). La page Resources contient la nouvelle ressource testDirectory.

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

Choisissez Ajouter.

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 TestLRA.

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

3. Dans Filtre thématique, saisissezLRA/test, puis choisissez Créer un abonnement.

La page Abonnements affiche le nouvel abonnement.

Configurez ensuite un abonnement qui invoque la fonction depuis AWS IoT.

Sur la page Abonnements, choisissez Ajouter un abonnement.

Sur la page Sélectionnez la source et la cible, configurez la source et la cible comme suit :

1. Pour Type de source, choisissez Fonction Lambda, puis IoT Cloud.

2. Pour Type de cible, choisissez Service, puis choisissez TestLRA.

3. Choisissez Suivant.

Dans la page Filtrer vos données avec une rubrique, dans Filtre de rubrique, saisissez invoke/LRAFunction, puis choisissez Suivant.

Choisissez Finish (Terminer). La page Abonnements affiche les deux abonnements.

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/1.11.6/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.

Si vous y êtes invité, dans l'onglet Fonction Lambda, sous Fonctions Lambda du système, sélectionnez Détecteur IP, puis Modifier, puis Détecter automatiquement.

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.

La page Déploiements indique l'horodatage, l'ID de version et l'état du déploiement. Une fois terminé, le statut du déploiement est Terminé.

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

Dans le menu de navigation de la AWS IoT console, sous Test, choisissez le client de test MQTT.

Sous S'abonner à une rubrique, dans Filtre thématique, saisissezLRA/test.

Dans Informations supplémentaires, pour l'affichage de la charge utile MQTT, sélectionnez Afficher les charges utiles sous forme de chaînes.

Choisissez Abonner. Votre fonction Lambda publie dans cette LRA/test rubrique.

Sous Publier dans une rubrique, saisissez le nom de la rubriqueinvoke/LRAFunction, puis choisissez Publier pour appeler votre fonction Lambda. Le test réussit si la page affiche les trois charges utiles de messages de la fonction.