Zurücksetzen von Bereitstellungen - AWS IoT Greengrass

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.

Zurücksetzen von Bereitstellungen

Diese Funktion ist für AWS IoT Greengrass Core v1.1 und höher verfügbar.

Sie können die Bereitstellungen einer Gruppe zurücksetzen auf:

  • Löschen Sie die Gruppe, z. B. wenn Sie den Kern der Gruppe in eine andere Gruppe verschieben möchten oder wenn der Kern der Gruppe neu abgebildet wurde. Bevor Sie eine Gruppe löschen, müssen Sie die Bereitstellungen der Gruppe zurücksetzen, um den Core mit einer anderen Greengrass-Gruppe zu verwenden.

  • Der Core der Gruppe soll in eine andere Gruppe verschoben werden.

  • Die Gruppe soll wieder in den Zustand vor der Bereitstellung versetzt werden.

  • Die Bereitstellungskonfiguration soll vom Core-Gerät entfernt werden.

  • Sensible Daten sollen vom Core-Gerät oder aus der Cloud gelöscht werden.

  • Eine neue Gruppenkonfiguration soll auf einem Core bereitgestellt werden, ohne dass der Core durch einen anderen in der aktuellen Gruppe ersetzt wird.

Anmerkung

Die Funktionalität zum Zurücksetzen von Bereitstellungen ist in AWS IoT Greengrass Core Software v1.0.0 nicht verfügbar. Sie können keine Gruppe löschen, die mit v1.0.0 bereitgestellt wurde.

Die Operation zum Zurücksetzen von Bereitstellungen bereinigt zunächst alle Bereitstellungsinformationen, die in der Cloud für eine bestimmte Gruppe gespeichert sind. Anschließend weist es das Core-Gerät der Gruppe an, alle ihre bereitstellungsbezogenen Informationen zu bereinigen (Lambda-Funktionen, Benutzerprotokolle, Schattendatenbank und Serverzertifikat, aber nicht die benutzerdefinierten config.json oder Greengrass-Core-Zertifikate). Die Bereitstellungen einer Gruppe können nicht zurückgesetzt werden, wenn für diese Gruppe aktuell eine Bereitstellung mit dem Status In Progress oder Building vorhanden ist.

Zurücksetzen von Bereitstellungen über die AWS IoT Konsole

Sie können Gruppenbereitstellungen von der Gruppenkonfigurationsseite in der -AWS IoTKonsole aus zurücksetzen.

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

  2. Wählen Sie die Zielgruppe aus.

  3. Wählen Sie auf der Registerkarte Bereitstellungen die Option Bereitstellungen zurücksetzen aus.

  4. Geben Sie im Dialogfeld Bereitstellungen für diese Greengrass-Gruppe zurücksetzen ein, confirm um zuzustimmen, und wählen Sie Bereitstellung zurücksetzen aus.

Zurücksetzen von Bereitstellungen mit der AWS IoT Greengrass-API

Sie können die ResetDeployments-Aktion in der AWS CLI, derAWS IoT Greengrass-API oder dem AWS-SDK verwenden, um Bereitstellungen zurückzusetzen. Die Beispiele in diesem Thema verwenden die CLI.

aws greengrass reset-deployments --group-id GroupId [--force]
Argumente für den CLI-Befehl reset-deployments:
--group-id

Die Gruppen-ID. Verwenden Sie den list-groups-Befehl, um diesen Wert abzurufen.

--force

Optional. Verwenden Sie diesen Parameter, wenn das Core-Gerät der Gruppe verloren, gestohlen oder zerstört wurde. Diese Option bewirkt, dass während des Zurücksetzens der Bereitstellungen eine Erfolgsmeldung ausgegeben wird, sobald alle Bereitstellungsinformationen in der Cloud gelöscht wurden, ohne auf die Antwort des Core-Geräts zu warten. Wenn das Core-Gerät jedoch aktiv ist oder wird, führt es auch Bereinigungsoperationen durch.

Die Ausgabe des CLI-Befehls reset-deployments sieht wie folgt aus:

{ "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef", "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef" }

Sie können den Status der Bereitstellungsrücksetzung mit dem CLI-Befehl get-deployment-status prüfen.

aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId
Argumente für den CLI-Befehl get-deployment-status:
--deployment-id

Die Bereitstellungs-ID.

--group-id

Die Gruppen-ID.

Die Ausgabe des CLI-Befehls get-deployment-status sieht wie folgt aus:

{ "DeploymentStatus": "Success", "UpdatedAt": "2017-04-04T00:00:00.000Z" }

Der Wert von DeploymentStatus wird auf Building gesetzt, wenn das Zurücksetzen der Bereitstellungen vorbereitet wird. Wenn die Reset-Bereitstellung bereit ist, der AWS IoT Greengrass Core die Reset-Bereitstellung jedoch nicht übernommen hat, DeploymentStatus ist InProgress.

Wenn das Zurücksetzen fehlschlägt, werden Fehlerinformationen in der Antwort zurückgegeben.

Weitere Informationen finden Sie auch unter