Erste Schritte mit Greengrass-Konnektoren (Konsole)

Melden Sie sich an der AWS Secrets Manager-Konsole an.

Wählen Sie Store a new secret (Ein neues Secret speichern).

UnderSecret-Typ wählen, wählenOther type of secret (Andere Art von Secret).

UnderAngabe der Schlüssel/Wert-Paare, die für dieses Geheimnis gespeichert werden sollen), auf derNur-Text, geben Sie Ihren Twilio auth token ein. Entfernen Sie alle JSON-Formatierungen und geben Sie nur den Token-Wert ein.

Behalten Sieaws/secretsmanagerfür den Verschlüsselungscode ausgewählt und wählen Sie dannWeiter.

Geben Sie für Secret name (Secret-Name) greengrass-TwilioAuthToken ein und klicken Sie auf Next (Weiter).

Dieses Tutorial erfordert keine Rotation. Wählen Sie also Disable automatic rotation (Automatische Rotation deaktivieren) und danachWeiter.

Prüfen Sie auf der Seite Review (Prüfen) Ihre Einstellungen und wählen Sie Store (Speichern).

Als nächstes erstellen Sie in Ihrer Greengrass-Gruppe eine geheime Ressource, die auf das Secret verweist.

In derAWS IoTNavigationsbereich der -Konsole, unterVerwalten, erweitern SieGreengrass-Geräteund wählen Sie dannGruppen (V1).

Wählen Sie die Gruppe, zu der Sie die geheime Ressource hinzufügen möchten.

Wählen Sie auf der Gruppenkonfigurationsseite die OptionRessourcenund scrollen Sie dann nach unten zur RegisterkarteSecretsAbschnitts erstellt. DieSecretszeigt die geheimen Ressourcen an, die zur Gruppe gehören. In diesem Abschnitt können Sie geheime Ressourcen hinzufügen, bearbeiten und entfernen.

Klicken Sie aufAddimSecretsAbschnitts erstellt.

Auf derHinzufügen einer geheimen RessourceSeite, geben SieMyTwilioAuthTokenfürRessourcenname.

Für denSecret, wählengreengrass-TwilioAuthToken.

In derBeschriftungen auswählen (optional)-Abschnitt erstellt AWSCURRENT Staging-Label stellt die neueste Version des Secrets dar. Dieses Label ist immer in einer geheimen Ressource enthalten.

Wählen Sie Add resource (Ressource hinzufügen) aus.

Wählen Sie auf der Gruppenkonfigurationsseite die Option Connectors (Konnektoren), und wählen Sie dann Add a connector (Konnektor hinzufügen).

Auf derHinzufügen eines Connector-Seite wählen SieTwilio-Benachrichtigungen.

Wählen Sie die -Version aus.

In derKonfigurationAbschnitts erstellt:

Wählen Sie Add resource (Ressource hinzufügen) aus.

AusAWS IoT GreengrassCore-SDKDownloads-Seite, laden Sie dieAWS IoT GreengrassCore SDK für Python auf Ihrem Computer.

Entpacken Sie das heruntergeladene Paket, um das SDK zu erhalten. Das SDK ist der greengrasssdk-Ordner.

Speichern Sie die folgende Pythoncode-Funktion in einer lokalen Datei namens 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))
    }

Packen Sie die folgenden Elemente in einer ZIP-Datei mit dem Namen temp_monitor_python.zip. Verwenden Sie zum Erstellen der ZIP-Datei nur den Code und die entsprechenden Abhängigkeiten und nicht den dazugehörigen Ordner.

Dies ist das Bereitstellungspaket Ihrer Lambda-Funktion.

Zunächst erstellen Sie die Lambda-Funktion.

1. Wählen Sie in der AWS Management Console Services und öffnen Sie die AWS Lambda-Konsole.

2. Klicken Sie aufFunktion erstellenund wählen Sie dannAuthor from scratch.

3. Verwenden Sie im Abschnitt Basic information (Basisinformationen) folgende Werte:

   • Geben Sie für Function name (Funktionsname) TempMonitor ein.

   • Wählen Sie für Runtime (Laufzeit) die Option Python 3.7 aus.

   • FürBerechtigungenverwenden, behalten Sie die Standardeinstellung bei. Dadurch wird eine Ausführungsrolle erstellt, die grundlegende Lambda-Berechtigungen gewährt. Diese Rolle wird nicht von verwendetAWS IoT Greengrass.

4. Klicken Sie unten auf der Seite auf Create function.

Registrieren Sie jetzt den Handler und laden Sie Ihr Bereitstellungspaket für Lambda-Funktion hoch

1. Auf derCodeTab, unterQuellcode, wählenHochladen von. Klicken Sie in der Dropdown-Liste aufZIP-Datei.

   

2. Klicken Sie aufHochladenund wählen Sie dann Ihrtemp_monitor_python.zipBereitstellungspaket. Wählen Sie dann Save (Speichern) aus.

3. Auf derCodefür die Funktion, unterRuntime-Einstellungen, wählenBearbeiten, und geben Sie dann die folgenden Werte ein.

   • Wählen Sie für Runtime (Laufzeit) die Option Python 3.7 aus.

   • Geben Sie unter Handler temp_monitor.function_handler ein.

4. Wählen Sie Save (Speichern) aus.

   Anmerkung

   DieTest-Schaltfläche aufAWS Lambda-Konsole funktioniert nicht mit dieser Funktion. DieAWS IoT GreengrassDas Core SDK enthält keine Module, die erforderlich sind, um Ihre Greengrass Lambda-Funktionen unabhängig imAWS Lambdaconsole. Diese Module (zum Beispielgreengrass_common) werden für die Funktionen bereitgestellt, nachdem sie in Ihrem Greengrass-Kern bereitgestellt wurden.

Veröffentlichen Sie jetzt die erste Version der Lambda-Funktion und erstellen Sie eineAlias für die Version.

1. Wählen Sie im Menü Actions die Option Publish new version aus.

2. Geben Sie unter Version description (Versionsbeschreibung) den Wert First version ein und wählen Sie dann Publish (Veröffentlichen) aus.

3. Auf derTempMonitor: 1-Konfigurationsseite, von derAktionenMenü wählen SieErstellen eines Alias.

4. Geben Sie auf der Seite Create a new alias folgende Werte an:

   • Geben Sie unter Name GG_TempMonitor ein.

   • Wählen Sie für Version die Option 1.

   Anmerkung

   AWS IoT Greengrassunterstützt keine Lambda-Aliassen für$LATESTVersionen erstellt.

5. Wählen Sie Create (Erstellen) aus.

Wählen Sie auf der Gruppenkonfigurationsseite die OptionLambda-FunktionenRegisterkarte.

UnderMeine Lambda-Funktionen, wählenAdd.

Auf derHinzufügen von Lambda-Funktion-Seite wählen SieTempMonitorfür Ihre Lambda-Funktion.

FürVersioning der Lambda-Funktion, wählenAlias: GG_TempMonitor.

Klicken Sie aufHinzufügen von Lambda-Funktion.

Wählen Sie auf der Gruppenkonfigurationsseite die OptionAbonnementsund wählen Sie dannAbo hinzufügen.

Auf derErstellen eines Abonnements-Seite, konfigurieren Sie die Quelle und das Ziel wie folgt:

1. FürRessourcentyp, wählenLambda-Funktionund wählen Sie dannTempMonitor.

2. FürZieltyp, wählen-Konnektorund wählen Sie dannTwilio-Benachrichtigungen.

Für denThemenfilter, wählentwilio/txt.

Wählen Sie Create subscription (Abonnement erstellen) aus.

Wiederholen Sie die Schritte 1 - 4, um ein Abonnement zu erstellen, das es AWS IoT ermöglicht, Nachrichten an die Funktion zu veröffentlichen.

1. FürRessourcentyp, wählenServiceund wählen Sie dannIoT Cloud.

2. FürWählen Sie ein Ziel aus, wählenLambda-Funktionund wählen Sie dannTempMonitor.

3. Geben Sie für Topic filter (Themenfilter) die Zeichenfolge temperature/input ein.

Wiederholen Sie die Schritte 1 - 4, um ein Abonnement zu erstellen, das es dem Konnektor ermöglicht, Nachrichten an AWS IoT zu veröffentlichen.

1. FürRessourcentyp, wählen-Konnektorund wählen Sie dannTwilio-Benachrichtigungen.

2. FürZieltyp, wählenServiceund wählen Sie dannIoT Cloud.

3. Für Themenfilter wird automatisch twilio/message/status eingegeben. Dies ist das vordefinierte Thema, in das der Konnektor veröffentlicht.

Stellen Sie sicher, dass dieAWS IoT Greengrasscore läuft. Führen Sie im Raspberry Pi-Terminal die folgenden Befehle aus, falls nötig.

1. So prüfen Sie, ob der Daemon ausgeführt wird:

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

   Wenn die Ausgabe einen root-Eintrag für /greengrass/ggc/packages/ggc-version/bin/daemon enthält, dann wird der Daemon ausgeführt.

   Anmerkung

   Die Version in dem Pfad hängt von der AWS IoT Greengrass-Core-Softwareversion ab, die auf Ihrem Core-Gerät installiert ist.

2. So starten Sie den Daemon:

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

Wählen Sie auf der Gruppenkonfigurationsseite die OptionBereitstellen.

1. In derLambda-Funktionenunter der RegisterkarteSystem-Lambda-FunktionenAbschnitt, wählen SieIP-Detektorund wähleBearbeiten.

2. In derEinstellungen für IP-Detektor bearbeiten-Dialogfeld wählen SieAutomatisches Erkennen und Überschreiben von MQTT-Broker-.

3. Wählen Sie Save (Speichern) aus.

   Damit können Geräte automatisch Core-Verbindungsinformationen abrufen, z. B. die IP-Adresse, DNS und die Portnummer. Die automatische Ermittlung wird empfohlen, aber AWS IoT Greengrass unterstützt auch manuell angegebene Endpunkte. Sie werden nur bei der ersten Bereitstellung der Gruppe zur Angabe der Ermittlungsmethode aufgefordert.

   Anmerkung

   Erteilen Sie bei Aufforderung die Berechtigung zum Erstellen desGreengrass-Servicerolleund assoziiere es mit deinemAWS-Kontoim aktuellenAWS-Region. Diese Rolle erlaubtAWS IoT Greengrassum auf Ihre -Ressourcen in zuzugreifenAWS-Services.

   Auf der Seite Deployments werden der Zeitstempel, die Versions-ID und der Status der Bereitstellung angegeben. Nach abgeschlossener Bereitstellung sollte der StatusCompleted (Abgeschlossen).

   Hilfe zur Problembehebung finden Sie unter Fehlerbehebung für AWS IoT Greengrass.

Auf derAWS IoT-Konsolen-Startseite, wählen SieTest.

FürAbonnieren eines -Themas, verwenden Sie die folgenden Werte und wählen Sie dannAbonnieren. Die Statusinformationen zu diesem Thema veröffentlicht der Twilio-Benachrichtigungs-Konnektor.

FürVeröffentlichung für ein Thema, verwenden Sie die folgenden Werte und wählen Sie dannVeröffentlichenum die Funktion aufzurufen.

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

Wenn erfolgreich, erhält der Empfänger die Textnachricht und die Konsole zeigt den Status success für die Ausgangsdaten.

Ändern Sie nun den temperature in der Eingabemeldung auf 29 und veröffentlichen Sie. Da dies weniger als 30 ist, ist der TempMonitor -Funktion löst keine Twilio-Nachricht aus.