Abrufen von Bereitstellungsbenachrichtigungen - AWS IoT Greengrass
Änderungsereignis für den GruppenbereitstellungsstatusVoraussetzungen für das Erstellen von EventBridge RegelnKonfigurieren von Bereitstellungsbenachrichtigungen (Konsole)Konfigurieren von Bereitstellungsbenachrichtigungen (CLI)Konfigurieren von Bereitstellungsbenachrichtigungen (AWS CloudFormation)Weitere Informationen finden Sie auch unter

AWS IoT Greengrass Version 1 trat am 30. Juni 2023 in die erweiterte Lebensphase ein. Weitere Informationen finden Sie in der AWS IoT Greengrass V1 Wartungsrichtlinie. Nach diesem Datum AWS IoT Greengrass V1 werden keine Updates mehr veröffentlicht, die Funktionen, Verbesserungen, Bugfixes oder Sicherheitspatches bieten. Geräte, die auf laufen, werden AWS IoT Greengrass V1 nicht gestört und funktionieren weiterhin und stellen eine Verbindung zur Cloud her. Wir empfehlen Ihnen dringend, zu migrieren AWS IoT Greengrass Version 2, da dies wichtige neue Funktionen und Unterstützung für zusätzliche Plattformen bietet.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abrufen von Bereitstellungsbenachrichtigungen

Amazon EventBridge -Ereignisregeln bieten Ihnen Benachrichtigungen über Statusänderungen für Ihre Greengrass-Gruppenbereitstellungen. EventBridge bietet einen Stream von Systemereignissen nahezu in Echtzeit, der Änderungen in beschreibtAWSRessourcen schätzen.AWS IoT Greengrasssendet diese Ereignisse an EventBridge auf einemmindestens einmalGrundlage. Dies bedeutet, dassAWS IoT Greengrasssendet möglicherweise mehrere Kopien eines bestimmten Ereignisses, um die Lieferung sicherzustellen. Außerdem empfangen Ihre Ereignis-Listener die Ereignisse möglicherweise nicht in der Reihenfolge, in der die Ereignisse aufgetreten sind.

Anmerkung

Amazon EventBridge ist ein Ereignisbus-Service, über den Sie Ihre Anwendungen mit Daten aus verschiedenen Quellen verbinden können, z.Greengrass-Kerngeräteund Bereitstellungsbenachrichtigungen. Weitere Informationen finden Sie unterWas ist Amazon? EventBridge?imAmazon EventBridge -Benutzerhandbuchaus.

AWS IoT Greengrass gibt ein Ereignis aus, wenn Gruppenbereitstellungen den Status ändern. Sie können ein erstellen EventBridge -Regel, die für alle Statusübergänge oder Übergänge in von Ihnen angegebene Status ausgeführt wird. Wenn eine Bereitstellung einen Status erhält, der eine Regel auslöst, EventBridge ruft die in der Regel definierten Zielaktionen auf. Auf diese Weise können Sie Benachrichtigungen senden, Ereignisinformationen erfassen, Korrekturmaßnahmen ergreifen oder andere Ereignisse als Reaktion auf eine Statusänderung initiieren. Sie können beispielsweise Regeln für die folgenden Anwendungsfälle erstellen:

  • Starten Sie Vorgänge nach der Bereitstellung, z. B. das Herunterladen von Komponenten und das Benachrichtigen von Mitarbeitern.

  • Senden Sie Benachrichtigungen bei erfolgreicher oder fehlgeschlagener Bereitstellung.

  • Veröffentlichen Sie benutzerdefinierte Metriken zu Bereitstellungsereignissen.

AWS IoT Greengrass gibt ein Ereignis aus, wenn eine Bereitstellung in folgende Status wechselt: Building, InProgress, Success und Failure.

Anmerkung

Die Überwachung des Status einer Sammelbereitstellungsoperation wird derzeit nicht unterstützt. Allerdings gibt AWS IoT Greengrass Statusänderungsereignisse für einzelne Gruppenbereitstellungen aus, die Teil einer Sammelbereitstellung sind.

Änderungsereignis für den Gruppenbereitstellungsstatus

Das Ereignis für eine Änderung des Bereitstellungsstatus verwendet das folgende Format:

{
    "version":"0",
    "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
    "detail-type":"Greengrass Deployment Status Change",
    "source":"aws.greengrass",
    "account":"123456789012",
    "time":"2018-03-22T00:38:11Z",
    "region":"us-west-2",
    "resources":[],
    "detail":{    
        "group-id": "284dcd4e-24bc-4c8c-a770-EXAMPLEf03b8",
        "deployment-id": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
        "deployment-type": "NewDeployment|Redeployment|ResetDeployment|ForceResetDeployment",
        "status": "Building|InProgress|Success|Failure"
    }
}

Sie können Regeln erstellen, die für mindestens eine Gruppe gelten. Sie können Regeln nach mindestens einem der folgenden Bereitstellungstypen und Bereitstellungsstatus filtern:

Bereitstellungstypen

  • NewDeploymentaus. Die erste Bereitstellung einer Gruppenversion.

  • ReDeploymentaus. Eine erneute Bereitstellung einer Gruppenversion.

  • ResetDeploymentaus. Löscht Bereitstellungsinformationen, die in der gespeichert sindAWS Cloudund auf derAWS IoT GreengrassCores. Weitere Informationen finden Sie unter Zurücksetzen von Bereitstellungen.

  • ForceResetDeploymentaus. Löscht Bereitstellungsinformationen, die in der gespeichert sindAWS Cloudund meldet Erfolg, ohne darauf zu warten, dass der Core reagiert. Löscht außerdem Bereitstellungsinformationen, die auf dem Core gespeichert sind, wenn der Core verbunden ist oder wenn er das nächste Mal eine Verbindung herstellt.

Bereitstellungsstatus

  • Building. AWS IoT Greengrass validiert die Gruppenkonfiguration und erstellt Bereitstellungsartefakte.

  • InProgressaus. Die Bereitstellung wird auf der ausgeführtAWS IoT GreengrassCores.

  • Successaus. Die Bereitstellung war erfolgreich.

  • Failureaus. Die Bereitstellung ist fehlgeschlagen.

Es ist möglich, dass Ereignisse doppelt sind oder nicht in der richtigen Reihenfolge werden. Um die Reihenfolge der Ereignisse zu bestimmen, verwenden Sie die time-Eigenschaft.

Anmerkung

AWS IoT Greengrass verwendet die resources-Eigenschaft nicht, daher ist sie immer leer.

Voraussetzungen für das Erstellen von EventBridge Regeln

Bevor Sie ein erstellen EventBridge Regel fürAWS IoT Greengrasswie folgt:

  • Machen Sie sich mit den Ereignissen, Regeln und Zielen in vertraut EventBridgeaus.

  • Erstellen und konfigurieren Sie die Ziele, die anhand Ihres aufgerufen werden EventBridge Regeln. Regeln können viele Arten von Zielen aufrufen, einschließlich:

    • Amazon Simple Notification Service (Amazon SNS)

    • AWS Lambda-Funktionen

    • Amazon Kinesis Video Streams

    • Amazon-Simple-Queue-Service-(Amazon-SQS)-Warteschlangen

Weitere Informationen finden Sie unterWas ist Amazon? EventBridge?undErste Schritte mit Amazon EventBridgeimAmazon EventBridge -Benutzerhandbuchaus.

Konfigurieren von Bereitstellungsbenachrichtigungen (Konsole)

Führen Sie die folgenden Schritte aus, um einen zu erstellen EventBridge -Regel, die ein Amazon SNS-Thema veröffentlicht, wenn sich der Bereitstellungsstatus für eine Gruppe ändert. Auf diese Weise können Webserver, E-Mail-Adressen und andere Themenabonnenten auf das Ereignis reagieren. Weitere Informationen finden Sie unterErstellen einer EventBridge Regel, die bei einem Ereignis aus einem ausgelöst wirdAWSRessourceimAmazon EventBridge -Benutzerhandbuchaus.

  1. Öffnen SieAmazon EventBridgeKonsoleaus.

  2. Wählen Sie im Navigationsbereich Rules aus.

  3. Wählen Sie Create rule (Regel erstellen).

  4. Geben Sie einen Namen und eine Beschreibung für die Regel ein.

    Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Ereignisbus haben.

  5. Wählen Sie für Event bus (Ereignisbus) den Ereignisbus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenenKonto übereinstimmt, wählen SieAWSStandard-Ereignisbusaus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird dieses stets an den Standardereignisbus Ihres Kontos weitergeleitet.

  6. Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.

  7. Wählen Sie Next (Weiter).

  8. Als Event source (Ereignisquelle) wählen Sie AWS-Services aus.

  9. FürEreignismuster, wählenAWSDienstleistungenaus.

  10. FürAWSBedienung, wählen Sie Greengrass.

  11. Wählen Sie für Ereignistyp die Option Greengrass Deployment Status Change (Änderung des Status der Greengrass-Bereitstellung).

    Anmerkung

    DieAWSAPI-Aufruf über CloudTrailEreignistyp basiert aufAWS IoT GreengrassIntegration von inAWS CloudTrailaus. Sie können diese Option verwenden, um -Regeln zu erstellen, die durch Lese- oder Schreibaufrufe an denAWS IoT GreengrassAPI. Weitere Informationen finden Sie unter Protokollierung von AWS IoT Greengrass-API-Aufrufen mit AWS CloudTrail.

  12. Wählen Sie die Bereitstellungsstatus aus, die eine Benachrichtigung auslösen.

    • Um Benachrichtigungen für alle Statusänderungsereignisse zu erhalten, wählen Sie Any state (Beliebiger Status).

    • Um Benachrichtigungen nur für bestimmte Statusänderungsereignisse zu erhalten, wählen Sie Specific state(s) (Spezifische(r) Status) und dann die Zielstatus aus.

  13. Wählen Sie die Bereitstellungstypen, die eine Benachrichtigung auslösen.

    • Um Benachrichtigungen für alle Bereitstellungstypen zu erhalten, wählen Sie Any state (Beliebiger Status).

    • Um Benachrichtigungen nur für bestimmte Bereitstellungstypen zu erhalten, wählen Sie Specific state(s) (Spezifische(r) Status) und dann die Zielbereitstellungstypen aus.

  14. Wählen Sie Next (Weiter).

  15. Bei Target types (Zieltypen) wählen Sie AWS-Service aus.

  16. FürWählen Sie ein Ziel aus, konfigurieren Sie Ihr Ziel. In diesem Beispiel wird ein Amazon SNS-Thema verwendet, Sie können jedoch auch andere Zieltypen zum Senden von Benachrichtigungen konfigurieren.

    1. Wählen Sie in Target (Ziel) die Option SNS topic (SNS-Thema) aus.

    2. Wählen Sie unter Thema das Zielthema aus.

    3. Wählen Sie Next (Weiter).

  17. UnderTags, definieren Sie Tags für die Regel oder lassen Sie die Felder leer.

  18. Wählen Sie Next (Weiter).

  19. Überprüfen Sie die Details der Regel und wählen Sie dann Create rule (Regel erstellen) aus.

Konfigurieren von Bereitstellungsbenachrichtigungen (CLI)

Führen Sie die folgenden Schritte aus, um einen zu erstellen EventBridge -Regel, die ein Amazon SNS-Thema veröffentlicht, wenn sich der Bereitstellungsstatus für eine Gruppe ändert. Auf diese Weise können Webserver, E-Mail-Adressen und andere Themenabonnenten auf das Ereignis reagieren.

  1. Erstellen Sie die -Regel.

    • Ersetzengroup-idmit der ID IhresAWS IoT GreengrassGruppe.

    aws events put-rule \
  --name TestRule \
  --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"

    Eigenschaften, die aus dem Muster weggelassen werden, werden ignoriert.

  2. Fügen Sie das Thema als Regelziel hinzu.

    • Ersetzenthema-arnmit dem ARN Ihres Amazon SNS-Themas.

    aws events put-targets \
  --rule TestRule \
  --targets "Id"="1","Arn"="topic-arn"
    Anmerkung

    Um Amazon zuzulassen EventBridge um Ihr Zielthema aufzurufen, müssen Sie Ihrem Thema eine ressourcenbasierte Richtlinie hinzufügen. Weitere Informationen finden Sie unterAmazon SNS SNS-BerechtigungenimAmazon EventBridge -Benutzerhandbuchaus.

Weitere Informationen finden Sie unterEreignisse und Ereignismuster in EventBridgeimAmazon EventBridge -Benutzerhandbuchaus.

Konfigurieren von Bereitstellungsbenachrichtigungen (AWS CloudFormation)

Verwenden vonAWS CloudFormationzu erstellende Vorlagen EventBridge -Regeln, die Benachrichtigungen über Statusänderungen für Ihre Greengrass-Gruppenbereitstellungen senden. Weitere Informationen finden Sie unterAmazon EventBridge RessourcentypenreferenzimAWS CloudFormation-Benutzerhandbuchaus.

Weitere Informationen finden Sie auch unter