Erstellen einer geheimen Ressource (Konsole)

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

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

Wählen Sie unter Geheimtyp auswählen die Option Anderer Geheimtyp aus.

Unter Specify the key/value pairs to be stored for this secret (Angabe der Schlüssel/Wert-Paare, die für dieses Secret gespeichert werden sollen):

Behalten Sie die aws/secretsmanager Auswahl für den Verschlüsselungsschlüssel bei und wählen Sie dann Weiter aus.

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

Für dieses Tutorial ist keine Rotation erforderlich. Wählen Sie daher „Automatische Rotation deaktivieren“ und dann „Weiter“.

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.

Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter Verwalten die Option Greengrass-Geräte und wählen Sie dann Groups (V1) aus.

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

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Ressourcen und scrollen Sie dann nach unten zum Abschnitt Secrets. Im Abschnitt Geheimnisse werden die geheimen Ressourcen angezeigt, die zur Gruppe gehören. Sie können geheime Ressourcen zu diesem Abschnitt hinzufügen, bearbeiten und entfernen.

Wählen Sie im Abschnitt Secrets die Option Hinzufügen aus.

Geben Sie auf der Seite Geheime Ressource hinzufügen MyTestSecret den Namen der Ressource ein.

Wählen Sie unter Secret die Option greengrass- TestSecret aus.

Im Abschnitt Select labels (optional) steht das AWSCURRENT-Staging-Label für die neueste Version des Secrets. Dieses Label ist immer in einer geheimen Ressource enthalten.

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

Laden Sie das AWS IoT Greengrass Core SDK für Python von der AWS IoT Greengrass Core-SDK-Downloadseite auf Ihren Computer herunter.

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 secret_test.py.

import greengrasssdk

secrets_client = greengrasssdk.client("secretsmanager")
iot_client = greengrasssdk.client("iot-data")
secret_name = "greengrass-TestSecret"
send_topic = "secrets/output"


def function_handler(event, context):
    """
    Gets a secret and publishes a message to indicate whether the secret was
    successfully retrieved.
    """
    response = secrets_client.get_secret_value(SecretId=secret_name)
    secret_value = response.get("SecretString")
    message = (
        f"Failed to retrieve secret {secret_name}."
        if secret_value is None
        else f"Successfully retrieved secret {secret_name}."
    )
    iot_client.publish(topic=send_topic, payload=message)
    print("Published: " + message)

Die get_secret_value Funktion unterstützt den Namen oder ARN des Secrets Manager-Geheimnisses für den SecretId Wert. Dieses Beispiel verwendet den Namen des Secrets. Gibt für dieses Beispielgeheimnis das Schlüssel-Wert-Paar AWS IoT Greengrass zurück:. {"test":"abcdefghi"}

Packen Sie die folgenden Elemente in einer ZIP-Datei mit dem Namen secret_test_python.zip. Schließen Sie beim Erstellen einer ZIP-Datei nur den Code und die Abhängigkeiten ein, nicht den dazugehörigen Ordner.

Dies ist Ihr Paket zur Bereitstellung der Lambda-Funktion.

Erstellen Sie zunächst die Lambda-Funktion.

1. Wählen Sie in der die AWS-Managementkonsole Option Dienste aus und öffnen Sie die AWS Lambda Konsole.

2. Wählen Sie „Funktion erstellen“ und wählen Sie dann „Von Grund auf neu erstellen“.

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

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

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

   • Behalten Sie für Berechtigungen die Standardeinstellung bei. Dadurch wird eine Ausführungsrolle erstellt, die grundlegende Lambda-Berechtigungen gewährt. Diese Rolle wird nicht verwendet von AWS IoT Greengrass.

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

Registrieren Sie als Nächstes den Handler und laden Sie Ihr Lambda-Funktionsbereitstellungspaket hoch.

1. Wählen Sie auf der Registerkarte Code unter Codequelle die Option Hochladen von aus. Wählen Sie in der Dropdownliste die Option „.zip-Datei“ aus.

   

2. Wählen Sie Hochladen und dann Ihr secret_test_python.zip Bereitstellungspaket aus. Wählen Sie dann Save (Speichern) aus.

3. Wählen Sie auf der Registerkarte Code für die Funktion unter Laufzeiteinstellungen die Option Bearbeiten aus , 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 secret_test.function_handler ein.

4. Wählen Sie Speichern.

   Anmerkung

   Die Testschaltfläche auf der AWS Lambda Konsole funktioniert mit dieser Funktion nicht. Das AWS IoT Greengrass Core SDK enthält keine Module, die erforderlich sind, um Ihre Greengrass Lambda-Funktionen unabhängig in der AWS Lambda Konsole auszuführen. Diese Module (zum Beispielgreengrass_common) werden den Funktionen zur Verfügung gestellt, nachdem sie in Ihrem Greengrass-Kern bereitgestellt wurden.

Veröffentlichen Sie jetzt die erste Version Ihrer Lambda-Funktion und erstellen Sie einen Alias 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. Wählen Sie auf der Konfigurationsseite SecretTest: 1 im Menü Aktionen die Option Alias erstellen aus.

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

   • Geben Sie unter Name GG_SecretTest ein.

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

   Anmerkung

   AWS IoT Greengrass unterstützt keine Lambda-Aliase für $LATEST-Versionen.

5. Wählen Sie Erstellen aus.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Lambda-Funktionen.

Wählen Sie im Abschnitt Meine Lambda-Funktionen die Option Hinzufügen aus.

Wählen Sie für die Lambda-Funktion. SecretTest

Wählen Sie für die Version der Lambda-Funktion den Alias für die Version aus, die Sie veröffentlicht haben.

Nehmen Sie im Abschnitt Konfiguration der Lambda-Funktion die folgenden Aktualisierungen vor.

1. Um ohne Containerisierung zu laufen:

   • Wählen Sie für Systembenutzer und -gruppe. Another user ID/group ID Geben Sie für Systembenutzer-ID den Wert ein0. Geben Sie für Systemgruppen-ID den Wert ein0.

     Dadurch kann Ihre Lambda-Funktion als Root ausgeführt werden. Weitere Hinweise zur Ausführung als Root finden Sie unterEinstellung der Standardzugriffsidentität für Lambda-Funktionen in einer Gruppe.

     Tipp

     Sie müssen auch Ihre config.json Datei aktualisieren, um Root-Zugriff auf Ihre Lambda-Funktion zu gewähren. Das Verfahren finden Sie unterEine Lambda-Funktion als Root ausführen.

   • Wählen Sie für die Containerisierung der Lambda-Funktion die Option Kein Container aus.

     Weitere Hinweise zur Ausführung ohne Containerisierung finden Sie unter. Überlegungen bei der Wahl der Containerisierung von Lambda-Funktionen

   • Geben Sie in Timeout (Zeitüberschreitung) 10 seconds ein.

   • Wählen Sie für Pinned die Option True aus.

     Weitere Informationen finden Sie unter Lebenszykluskonfiguration für Greengrass Lambda-Funktionen.

   • Wählen Sie unter Zusätzlicher Parameter für Lesezugriff auf das Verzeichnis /sys die Option Aktiviert aus.

2. Um stattdessen im containerisierten Modus zu arbeiten:

   Anmerkung

   Wir empfehlen nicht, im containerisierten Modus zu arbeiten, es sei denn, Ihr Geschäftsfall erfordert dies.

   • Wählen Sie für Systembenutzer und Gruppe die Option Gruppenstandard verwenden aus.

   • Wählen Sie für die Containerisierung von Lambda-Funktionen die Option Gruppenstandard verwenden aus.

   • Geben Sie in Memory Limit (Speicherlimit) 1024 MB ein.

   • Geben Sie in Timeout (Zeitüberschreitung) 10 seconds ein.

   • Wählen Sie für Pinned die Option True aus.

     Weitere Informationen finden Sie unter Lebenszykluskonfiguration für Greengrass Lambda-Funktionen.

   • Wählen Sie unter Zusätzliche Parameter für Lesezugriff auf das Verzeichnis /sys die Option Aktiviert aus.

Wählen Sie Lambda-Funktion hinzufügen.

Wählen Sie auf der Seite mit der Gruppenkonfiguration die Registerkarte Lambda-Funktionen aus.

Wählen Sie die SecretTest Funktion aus.

Wählen Sie auf der Detailseite der Funktion Ressourcen aus.

Scrollen Sie zum Abschnitt Secrets und wählen Sie Associate aus.

Wählen Sie MyTestSecret und wählen Sie dann Associate aus.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Abonnements und dann Abonnement hinzufügen aus.

Erstellen Sie ein Abonnement, mit AWS IoT dem Sie Nachrichten für die Funktion veröffentlichen können.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Abonnements und dann Abonnement hinzufügen aus.

Konfigurieren Sie auf der Seite „Abonnement erstellen“ die Quelle und das Ziel wie folgt:

1. Wählen Sie unter Quelltyp die Lambda-Funktion und dann IoT Cloud aus.

2. Wählen Sie unter Zieltyp die Option Dienst aus, und wählen Sie SecretTest dann.

3. Geben Sie im Themenfilter Folgendes einsecrets/input, und wählen Sie dann Abonnement erstellen aus.

Hinzufügen eines zweiten Abonnements. Wählen Sie die Registerkarte Abonnements, wählen Sie Abonnement hinzufügen aus und konfigurieren Sie Quelle und Ziel wie folgt:

1. Wählen Sie unter Quelltyp die Option Dienste aus , und wählen Sie dann SecretTest.

2. Wählen Sie unter Zieltyp die Lambda-Funktion und dann IoT Cloud aus.

3. Geben Sie im Themenfilter Folgendes ein secrets/output, und wählen Sie dann Abonnement erstellen aus.

Stellen Sie sicher, dass der AWS IoT Greengrass Core 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 im Pfad hängt von der AWS IoT Greengrass Core-Softwareversion ab, die auf Ihrem Core-Gerät installiert ist.

2. Um den Daemon zu starten:

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

Wählen Sie auf der Seite mit der Gruppenkonfiguration die Option Deploy aus.

1. Wählen Sie auf der Registerkarte Lambda-Funktionen im Abschnitt System Lambda-Funktionen die Option IP Detector aus und klicken Sie auf Bearbeiten.

2. Wählen Sie im Dialogfeld IP-Detektoreinstellungen bearbeiten die Option MQTT-Broker-Endpunkte automatisch erkennen und überschreiben aus.

3. Wählen Sie Speichern.

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

   Anmerkung

   Wenn Sie dazu aufgefordert werden, erteilen Sie die Erlaubnis, die Greengrass-Servicerolle zu erstellen und sie Ihrer AWS-Konto in der aktuellen Rolle zuzuordnen. AWS-Region Diese Rolle ermöglicht AWS IoT Greengrass den Zugriff auf Ihre Ressourcen in AWS Diensten.

   Auf der Seite Deployments werden der Zeitstempel, die Versions-ID und der Status der Bereitstellung angegeben. Wenn der Vorgang abgeschlossen ist, sollte der für die Bereitstellung angezeigte Status „Abgeschlossen“ lauten.

   Hilfe zur Problembehebung finden Sie unter Fehlerbehebung AWS IoT Greengrass.

Wählen Sie auf der Startseite der AWS IoT Konsole Test aus.

Verwenden Sie für Thema abonnieren die folgenden Werte und wählen Sie dann Abonnieren aus.

Verwenden Sie für Im Thema veröffentlichen die folgenden Werte und wählen Sie dann Veröffentlichen, um die Funktion aufzurufen.

Im Erfolgsfall veröffentlicht die Funktion eine "Success"-Meldung.