Erste Schritte mit Greengrass-Konnektoren (CLI)

Erstellen Sie zunächst das Secret.

aws secretsmanager create-secret --name greengrass-TwilioAuthToken --secret-string twilio-auth-token

Kopieren Sie den ARN des Secrets aus der Ausgabe. Damit erstellen Sie die geheime Ressource und konfigurieren den Twilio-Benachrichtigungs-Konnektor.

Erstellen Sie eine Ressourcendefinition, die eine Initialversion enthält.

Kopieren Sie den LatestVersionArn der Ressourcendefinition aus der Ausgabe. Mit diesem Wert fügen Sie die Version der Ressourcendefinition der Gruppenversion hinzu, die Sie im Core bereitstellen.

Erstellen Sie eine Konnektordefinition mit einer Initialversion.

Kopieren Sie den LatestVersionArn der Konnektordefinition aus der Ausgabe. Mit diesem Wert fügen Sie die Version der Konnektordefinition der Gruppenversion hinzu, die Sie im Core bereitstellen.

Aus demAWS 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.

Erstellen Sie eine IAM-Rolle, damit Sie beim Anlegen der Funktion den Rollen-ARN übergeben können.

Kopieren Sie die Arn aus der Ausgabe.

Verwenden derAWS LambdaAPI zum Erstellen der TempMonitor Funktion. Der folgende Befehl geht davon aus, dass sich die Zip-Datei im aktuellen Verzeichnis befindet.

aws lambda create-function \
--function-name TempMonitor \
--zip-file fileb://temp_monitor_python.zip \
--role role-arn \
--handler temp_monitor.function_handler \
--runtime python3.7

Veröffentlichen einer Version der Funktion.

aws lambda publish-version --function-name TempMonitor --description 'First version'

Erstellen Sie einen Alias für die veröffentlichte Version.

Greengrass-Gruppen können eine Lambda-Funktion über einen Alias (empfohlen) oder nach Version referenzieren. Mit einem Alias lassen sich Code-Updates einfacher verwalten, da die Abonnementtabelle oder Gruppendefinition nicht geändert werden muss, wenn der Funktionscode aktualisiert wird. Stattdessen verweisen Sie einfach auf den Alias auf die neue Funktionsversion.

aws lambda create-alias --function-name TempMonitor --name GG_TempMonitor --function-version 1

Kopieren Sie die AliasArn aus der Ausgabe. Diesen Wert verwenden Sie bei der Konfiguration der Funktion für AWS IoT Greengrass und beim Anlegen eines Abonnements.

Erstellen Sie eine Funktionsdefinition, die eine Initialversion enthält.

Kopieren Sie die LatestVersionArn aus der Ausgabe. Mit diesem Wert fügen Sie die Version der Funktionsdefinition der Gruppenversion hinzu, die Sie im Core bereitstellen.

Kopieren Sie die Id aus der Ausgabe. Diesen Wert verwenden Sie später, wenn Sie die Funktion aktualisieren.

Erstellen Sie eine Abonnementdefinition, die eine Initialversion enthält, die die Abonnements umfasst.

Kopieren Sie die LatestVersionArn aus der Ausgabe. Mit diesem Wert fügen Sie die Version der Abonnementdefinition der Gruppenversion hinzu, die Sie im Core bereitstellen.

Rufen Sie die ID der Gruppe und die neueste Gruppenversion ab:

1. Rufen Sie die IDs der Greengrass-Zielgruppen und die Gruppenversion ab. Dieses Verfahren setzt voraus, dass es sich um die neueste Gruppe und Gruppenversion handelt. Die folgende Abfrage gibt die zuletzt erstellte Gruppe zurück.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   Sie können auch nach Namen abfragen. Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   Anmerkung

   Sie finden diese Werte auch inAWS IoTconsole. Die Gruppen-ID wird auf der Seite Einstellungen der Gruppe angezeigt. Gruppenversions-IDs werden auf denBereitstellungenRegisterkarte.

2. Kopieren Sie die Id der Zielgruppe aus der Ausgabe. Sie verwenden sie, um die Core-Definitionsversion zu erhalten, und wenn Sie die Gruppe bereitstellen.

3. Kopieren Sie die LatestVersion aus der Ausgabe, d. h. die ID der letzten Version, die der Gruppe hinzugefügt wurde. Damit erhalten Sie die Core-Definitionsversion.

Abrufen des ARN der Core-Definitionsversion:

1. Abrufen der Gruppenversion. Für diesen Schritt gehen wir davon aus, dass die neueste Gruppenversion eine Core-Definitionsversion enthält.

   • Ersetzen Sie group-id durch die kopierte Id für die Gruppe.

   • Ersetzengroup-version-idmit demLatestVersiondie du für die Gruppe kopiert hast.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id group-version-id

2. Kopieren Sie die CoreDefinitionVersionArn aus der Ausgabe.

Erstellen einer Gruppenversion

aws greengrass create-group-version \
--group-id group-id \
--core-definition-version-arn core-definition-version-arn \
--resource-definition-version-arn resource-definition-version-arn \
--connector-definition-version-arn connector-definition-version-arn \
--function-definition-version-arn function-definition-version-arn \
--subscription-definition-version-arn subscription-definition-version-arn

Kopieren Sie den Wert Version aus der Ausgabe. Dies ist die ID der Gruppenversion. Mit diesem Wert können Sie die Gruppenversion bereitstellen.

Stellen Sie in einem Core-Gerät-Terminal sicher, dass der AWS IoT Greengrass-Daemon läuft.

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/1.11.6/bin/daemon enthält, dann wird der Daemon ausgeführt.

2. So starten Sie den Daemon:

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

Erstellen einer Bereitstellung.

aws greengrass create-deployment \
--deployment-type NewDeployment \
--group-id group-id \
--group-version-id group-version-id

Kopieren Sie die DeploymentId aus der Ausgabe.

Abrufen des Bereitstellungsstatus.

aws greengrass get-deployment-status \
--group-id group-id \
--deployment-id deployment-id

Wenn der Status lautetSuccesswar die Bereitstellung erfolgreich. Hilfe zur Problembehebung finden Sie unter Fehlerbehebung für AWS IoT Greengrass.

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

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

FürVeröffentlichung für ein Thema, verwenden Sie die folgenden Werte und wählen SieVerö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, TempMonitor -Funktion löst keine Twilio-Nachricht aus.