Grüngraskern - AWS IoT Greengrass
VersionenAnforderungen an SpeichergeräteUnterstützte PlattformenBetriebssystemVoraussetzungenAbhängigkeitenHerunterladen und InstallationKonfigurationLokale ProtokolldateiÄnderungsprotokoll

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.

Grüngraskern

Die Greengrass Nucleus-Komponente (aws.greengrass.Nucleus) ist eine obligatorische Komponente und die Mindestanforderung, um die AWS IoT Greengrass Core-Software auf einem Gerät auszuführen. Sie können diese Komponente konfigurieren, um Ihre AWS IoT Greengrass Core-Software per Fernzugriff anzupassen und zu aktualisieren. Stellen Sie diese Komponente bereit, um Einstellungen wie Proxy, Geräterolle und AWS IoT Dingkonfiguration auf Ihren Kerngeräten zu konfigurieren.

Anmerkung

Ab der Greengrass-Version 2.14.0 ist eine für den Speicherbedarf optimierte Version der Nucleus-Gerätelaufzeit für Geräte mit eingeschränkten Randbedingungen verfügbar. Weitere Informationen zu Konfiguration und Verwendung finden Sie unter Greengrass Nucleus Lite.

Wichtig

Wenn sich die Version der Nucleus-Komponente ändert oder wenn Sie bestimmte Konfigurationsparameter ändern, wird die AWS IoT Greengrass Core-Software — zu der auch der Nucleus und alle anderen Komponenten auf Ihrem Gerät gehören — neu gestartet, um die Änderungen zu übernehmen.

Wenn Sie eine Komponente bereitstellen, werden die neuesten unterstützten Versionen aller Abhängigkeiten dieser Komponente AWS IoT Greengrass installiert. Aus diesem Grund werden neue Patch-Versionen von AWS bereitgestellten öffentlichen Komponenten möglicherweise automatisch auf Ihren Kerngeräten bereitgestellt, wenn Sie einer Dinggruppe neue Geräte hinzufügen oder wenn Sie die Bereitstellung aktualisieren, die auf diese Geräte abzielt. Einige automatische Updates, wie z. B. ein Nucleus-Update, können dazu führen, dass Ihre Geräte unerwartet neu gestartet werden.

Um unbeabsichtigte Updates für eine Komponente zu verhindern, die auf Ihrem Gerät ausgeführt wird, empfehlen wir, dass Sie Ihre bevorzugte Version dieser Komponente direkt angeben, wenn Sie eine Bereitstellung erstellen. Weitere Informationen zum Aktualisierungsverhalten der AWS IoT Greengrass Core-Software finden Sie unterAktualisieren Sie die AWS IoT Greengrass Core-Software (OTA).

Versionen

Diese Komponente hat die folgenden Versionen:

  • 2.14.x

  • 2.13.x

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Anforderungen an Speichergeräte

Anmerkung

Mithilfe AWS IoT Device Tester von können Sie überprüfen AWS IoT Greengrass , ob Ihr Gerät die AWS IoT Greengrass Core-Software ausführen und mit dem AWS Cloud kommunizieren kann. Weitere Informationen finden Sie unter AWS IoT Device Tester Für AWS IoT Greengrass V2 verwenden.

Linux

  • Die Verwendung eines AWS-Region, der unterstützt AWS IoT Greengrass V2. Eine vollständige Liste der unterstützten Regionen finden Sie unter AWS IoT Greengrass V2 -Endpunkte und -Kontingente in Allgemeine AWS-Referenz.

  • Für die AWS IoT Greengrass Core-Software stehen mindestens 256 MB Festplattenspeicher zur Verfügung. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät bereitgestellt werden.

  • Der AWS IoT Greengrass Core-Software sind mindestens 96 MB RAM zugewiesen. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät ausgeführt werden. Weitere Informationen finden Sie unter Steuern Sie die Speicherzuweisung mit JVM-Optionen.

  • Java Runtime Environment (JRE) Version 8 oder höher. Java muss in der Umgebungsvariablen PATH auf dem Gerät verfügbar sein. Um Java zur Entwicklung benutzerdefinierter Komponenten zu verwenden, müssen Sie ein Java Development Kit (JDK) installieren. Wir empfehlen, dass Sie die Langzeit-Support-Versionen von Amazon Corretto oder OpenJDK verwenden. Version 8 oder höher ist erforderlich.

  • GNU C-Bibliothek (Glibc) Version 2.25 oder höher.

  • Sie müssen die AWS IoT Greengrass Core-Software als Root-Benutzer ausführen. Verwenden sudo Sie zum Beispiel.

  • Der Root-Benutzer, der die AWS IoT Greengrass Core-Software ausführtroot, muss beispielsweise über die Berechtigung verfügen, sudo mit jedem Benutzer und jeder Gruppe zu arbeiten. Die /etc/sudoers Datei muss diesem Benutzer die Berechtigung geben, zusammen mit anderen Gruppen ausgeführt sudo zu werden. Die Zugriffsrechte für den Benutzer /etc/sudoers sollten wie im folgenden Beispiel aussehen.

    root    ALL=(ALL:ALL) ALL

  • Das Kerngerät muss in der Lage sein, ausgehende Anfragen an eine Reihe von Endpunkten und Ports auszuführen. Weitere Informationen finden Sie unter Geräteverkehr über einen Proxy oder eine Firewall zulassen.

  • Das /tmp Verzeichnis muss mit exec entsprechenden Berechtigungen bereitgestellt werden.

  • Alle folgenden Shell-Befehle:

    • ps -ax -o pid,ppid

    • sudo

    • sh

    • kill

    • cp

    • chmod

    • rm

    • ln

    • echo

    • exit

    • id

    • uname

    • grep

  • Ihr Gerät benötigt möglicherweise auch die folgenden optionalen Shell-Befehle:

    • (Optional) systemctl. Dieser Befehl wird verwendet, um die AWS IoT Greengrass Core-Software als Systemdienst einzurichten.

    • (Optional) useraddgroupadd, undusermod. Diese Befehle werden verwendet, um den ggc_user Systembenutzer und die ggc_group Systemgruppe einzurichten.

    • (Optional) mkfifo. Dieser Befehl wird verwendet, um Lambda-Funktionen als Komponenten auszuführen.

  • Um Systemressourcenlimits für Komponentenprozesse zu konfigurieren, muss auf Ihrem Gerät die Linux-Kernel-Version 2.6.24 oder höher ausgeführt werden.

  • Um Lambda-Funktionen ausführen zu können, muss Ihr Gerät zusätzliche Anforderungen erfüllen. Weitere Informationen finden Sie unter Anforderungen an die Lambda-Funktion.

Windows

  • Die Verwendung eines AWS-Region, der unterstützt AWS IoT Greengrass V2. Eine vollständige Liste der unterstützten Regionen finden Sie unter AWS IoT Greengrass V2 -Endpunkte und -Kontingente in Allgemeine AWS-Referenz.

  • Für die AWS IoT Greengrass Core-Software stehen mindestens 256 MB Festplattenspeicher zur Verfügung. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät bereitgestellt werden.

  • Der AWS IoT Greengrass Core-Software sind mindestens 160 MB RAM zugewiesen. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät ausgeführt werden. Weitere Informationen finden Sie unter Steuern Sie die Speicherzuweisung mit JVM-Optionen.

  • Java Runtime Environment (JRE) Version 8 oder höher. Java muss in der Systemvariablen PATH auf dem Gerät verfügbar sein. Um Java zur Entwicklung benutzerdefinierter Komponenten zu verwenden, müssen Sie ein Java Development Kit (JDK) installieren. Wir empfehlen, dass Sie die Langzeit-Support-Versionen von Amazon Corretto oder OpenJDK verwenden. Version 8 oder höher ist erforderlich..

    Anmerkung

    Um Version 2.5.0 von Greengrass Nucleus verwenden zu können, müssen Sie eine 64-Bit-Version von Java Runtime Environment (JRE) verwenden. Greengrass Nucleus Version 2.5.1 unterstützt 32-Bit und 64-Bit. JREs

  • Der Benutzer, der die AWS IoT Greengrass Core-Software installiert, muss Administrator sein.

  • Sie müssen die AWS IoT Greengrass Core-Software als Systemdienst installieren. Geben Sie an--setup-system-service true, wann Sie die Software installieren.

  • Jeder Benutzer, der Komponentenprozesse ausführt, muss in dem LocalSystem Konto vorhanden sein, und der Name und das Passwort des Benutzers müssen sich in der Credential Manager-Instanz für das LocalSystem Konto befinden. Sie können diesen Benutzer einrichten, wenn Sie den Anweisungen zur Installation der AWS IoT Greengrass Core-Software folgen.

  • Das Core-Gerät muss in der Lage sein, ausgehende Anfragen an eine Reihe von Endpunkten und Ports auszuführen. Weitere Informationen finden Sie unter Geräteverkehr über einen Proxy oder eine Firewall zulassen.

Unterstützte Plattformen

AWS IoT Greengrass unterstützt offiziell Geräte, auf denen die folgenden Plattformen ausgeführt werden. Geräte mit Plattformen, die nicht in dieser Liste aufgeführt sind, funktionieren möglicherweise, AWS IoT Greengrass Tests werden jedoch nur auf diesen angegebenen Plattformen durchgeführt.

Linux

Architekturen:

  • Armv7l

  • Armv8 () AArch64

  • x86_64

Windows

Architekturen:

  • x86_64

Versionen:

  • Windows 10

  • Windows 11

  • Windows Server 2019

  • Windows Server 2022

Anmerkung

Einige AWS IoT Greengrass Funktionen werden derzeit auf Windows-Geräten nicht unterstützt. Weitere Informationen erhalten Sie unter Kompatibilität der Greengrass-Funktionen und Überlegungen zu Funktionen für Windows-Geräte.

Überlegungen zu Funktionen für Windows-Geräte

Einige AWS IoT Greengrass Funktionen werden derzeit auf Windows-Geräten nicht unterstützt. Überprüfen Sie die Funktionsunterschiede, um zu überprüfen, ob ein Windows-Gerät Ihren Anforderungen entspricht. Weitere Informationen finden Sie unter Kompatibilität der Greengrass-Funktionen.

Linux-Plattformen können auch AWS IoT Greengrass V2 in einem Docker-Container ausgeführt werden. Weitere Informationen finden Sie unter Führen Sie die AWS IoT Greengrass Core-Software in einem Docker-Container aus.

Um ein benutzerdefiniertes Linux-basiertes Betriebssystem zu erstellen, können Sie das BitBake Rezept für AWS IoT Greengrass V2 im meta-aws Projekt verwenden. Das meta-aws Projekt bietet Rezepte, mit denen Sie AWS Edge-Softwarefunktionen in eingebetteten Linux-Systemen erstellen können, die mit OpenEmbeddedBuild-Frameworks von Yocto Project erstellt wurden. Das Yocto-Projekt ist ein Open-Source-Kooperationsprojekt, das Ihnen hilft, maßgeschneiderte Linux-basierte Systeme für eingebettete Anwendungen unabhängig von der Hardwarearchitektur zu entwickeln. Das BitBake Rezept für AWS IoT Greengrass V2 installiert, konfiguriert und führt die AWS IoT Greengrass Core-Software automatisch auf Ihrem Gerät aus.

Betriebssystem

Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:

  • Linux

  • Windows

Weitere Informationen finden Sie unter Unterstützte Plattformen.

Voraussetzungen

Geräte müssen bestimmte Anforderungen erfüllen, um den Greengrass Nucleus und die AWS IoT Greengrass Core-Software installieren und ausführen zu können. Weitere Informationen finden Sie unter Anforderungen an Speichergeräte.

Die Greengrass Nucleus-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.

  • Die Greengrass Nucleus-Komponente muss über Konnektivität zu AWS IoT data, AWS IoT Credentials und Amazon S3 verfügen.

Abhängigkeiten

Der Greengrass-Kern beinhaltet keine Komponentenabhängigkeiten. Einige der von AWS-bereitgestellten Komponenten beinhalten jedoch den Nukleus als Abhängigkeit. Weitere Informationen finden Sie unter AWS-mitgelieferte Komponenten.

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Rezeptreferenz für Komponenten.

Herunterladen und Installation

Sie können ein Installationsprogramm herunterladen, das die Greengrass Nucleus-Komponente auf Ihrem Gerät einrichtet. Dieses Installationsprogramm richtet Ihr Gerät als Greengrass-Core-Gerät ein. Es gibt zwei Arten von Installationen, die Sie durchführen können: eine Schnellinstallation, bei der die erforderlichen AWS Ressourcen für Sie erstellt werden, oder eine manuelle Installation, bei der Sie die AWS Ressourcen selbst erstellen. Weitere Informationen finden Sie unter Installieren Sie die AWS IoT Greengrass Core-Software.

Sie können auch einem Tutorial folgen, um den Greengrass-Kern zu installieren und sich mit der Entwicklung von Greengrass-Komponenten vertraut zu machen. Weitere Informationen finden Sie unter Tutorial: Erste Schritte mit AWS IoT Greengrass V2.

Konfiguration

Diese Komponente bietet die folgenden Konfigurationsparameter, die Sie bei der Bereitstellung der Komponente anpassen können. Einige Parameter setzen voraus, dass die AWS IoT Greengrass Core-Software neu gestartet wird, um wirksam zu werden. Weitere Informationen darüber, warum und wie diese Komponente konfiguriert wird, finden Sie unterKonfiguration der AWS IoT Greengrass Core-Software.

iotRoleAlias

Der AWS IoT Rollenalias, der auf eine Token-Exchange-IAM-Rolle verweist. Der Anbieter AWS IoT für Anmeldeinformationen übernimmt diese Rolle, damit das Greengrass-Core-Gerät mit AWS Diensten interagieren kann. Weitere Informationen finden Sie unter Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS.

Wenn Sie die AWS IoT Greengrass Core-Software mit dieser --provision true Option ausführen, stellt die Software einen Rollenalias bereit und legt seinen Wert in der Nucleus-Komponente fest.

interpolateComponentConfiguration

(Optional) Sie können den Greengrass-Kern aktivieren, um Rezeptvariablen für Komponenten in Komponentenkonfigurationen zu interpolieren und Konfigurationsupdates zusammenzuführen. Wir empfehlen, diese Option auf zu setzen, true damit das Kerngerät Greengrass-Komponenten ausführen kann, die Rezeptvariablen in ihren Konfigurationen verwenden.

Diese Funktion ist für Version 2.6.0 und höher dieser Komponente verfügbar.

Standard: false

networkProxy

(Optional) Der Netzwerk-Proxy, der für alle Verbindungen verwendet werden soll. Weitere Informationen finden Sie unter Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy.

Wichtig

Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.

Dieses Objekt enthält die folgenden Informationen:

noProxyAddresses

(Optional) Eine durch Kommas getrennte Liste von IP-Adressen oder Hostnamen, die vom Proxy ausgenommen sind.

proxy

Der Proxy, zu dem eine Verbindung hergestellt werden soll. Dieses Objekt enthält die folgenden Informationen:

url

Die URL des Proxyservers im Formatscheme://userinfo@host:port.

  • scheme— Das Schema, das http oder sein musshttps.

    Wichtig

    Greengrass-Core-Geräte müssen Greengrass Nucleus v2.5.0 oder höher ausführen, um HTTPS-Proxys verwenden zu können.

    Wenn Sie einen HTTPS-Proxy konfigurieren, müssen Sie das Proxy-Server-CA-Zertifikat zum Amazon-Root-CA-Zertifikat des Kerngeräts hinzufügen. Weitere Informationen finden Sie unter Ermöglichen Sie dem Kerngerät, einem HTTPS-Proxy zu vertrauen.

  • userinfo— (Optional) Der Benutzername und das Passwort. Wenn Sie diese Informationen in der angebenurl, ignoriert das Greengrass-Core-Gerät die Felder username undpassword.

  • host— Der Hostname oder die IP-Adresse des Proxyservers.

  • port— (Optional) Die Portnummer. Wenn Sie den Port nicht angeben, verwendet das Greengrass-Core-Gerät die folgenden Standardwerte:

    • http— 80

    • https— 443

username

(Optional) Der Benutzername, der den Proxyserver authentifiziert.

password

(Optional) Das Passwort, das den Proxyserver authentifiziert.

mqtt

(Optional) Die MQTT-Konfiguration für das Greengrass-Core-Gerät. Weitere Informationen finden Sie unter Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy.

Wichtig

Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.

Dieses Objekt enthält die folgenden Informationen:

port

(Optional) Der Port, der für MQTT-Verbindungen verwendet werden soll.

Standard: 8883

keepAliveTimeoutMs

(Optional) Die Zeitspanne in Millisekunden zwischen den einzelnen PING Nachrichten, die der Client sendet, um die MQTT-Verbindung aufrechtzuerhalten. Dieser Wert muss größer als sein. pingTimeoutMs

Standard: 60000 (60 Sekunden)

pingTimeoutMs

(Optional) Die Zeit in Millisekunden, die der Client auf den Empfang einer PINGACK Nachricht vom Server wartet. Wenn die Wartezeit das Timeout überschreitet, schließt das Kerngerät die MQTT-Verbindung und öffnet sie erneut. Dieser Wert muss kleiner als sein. keepAliveTimeoutMs

Standard: 30000 (30 Sekunden)

operationTimeoutMs

(Optional) Die Zeit in Millisekunden, die der Client auf den Abschluss von MQTT-Operationen (wie CONNECT oder) wartet. PUBLISH Diese Option gilt nicht für PING MQTT- oder Keep-Alive-Nachrichten.

Standard: 30000 (30 Sekunden)

maxInFlightPublishes

(Optional) Die maximale Anzahl unbestätigter MQTT QoS 1-Nachrichten, die gleichzeitig gesendet werden können.

Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.

Standard: 5

Gültiger Bereich: Maximalwert von 100

maxMessageSizeInBytes

(Optional) Die maximale Größe einer MQTT-Nachricht. Wenn eine Nachricht diese Größe überschreitet, lehnt der Greengrass-Kern die Nachricht mit einem Fehler ab.

Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.

Standard: 131072 (128 KB)

Gültiger Bereich: Maximalwert von 2621440 (2,5 MB)

maxPublishRetry

(Optional) Gibt an, wie oft eine Nachricht, deren Veröffentlichung fehlschlägt, maximal wiederholt werden soll. Sie können angeben, dass der -1 Wiederholungsversuch unbegrenzt oft erfolgen soll.

Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.

Standard: 100

spooler

(Optional) Die MQTT-Spooler-Konfiguration für das Greengrass-Core-Gerät. Dieses Objekt enthält die folgenden Informationen:

storageType

Der Speichertyp zum Speichern von Nachrichten. Wenn auf eingestellt storageType istDisk, pluginName kann der konfiguriert werden. Sie können entweder Memory oder Disk angeben.

Diese Funktion ist für Version 2.11.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Wichtig

Wenn der MQTT-Spooler auf eingestellt storageType ist Disk und Sie Greengrass Nucleus von Version 2.11.x auf eine frühere Version downgraden möchten, müssen Sie die Konfiguration wieder auf ändern. Memory Die einzige Konfiguration dafürstorageType, die in den Greengrass Nucleus-Versionen 2.10.x und früher unterstützt wird, ist. Memory Die Nichtbeachtung dieser Anleitung kann dazu führen, dass der Spooler kaputt geht. Dies würde dazu führen, dass Ihr Greengrass-Core-Gerät keine MQTT-Nachrichten an den senden kann. AWS Cloud

Standard: Memory

pluginName

(Optional) Der Name der Plugin-Komponente. Diese Komponente wird nur verwendet, wenn sie auf gesetzt storageType istDisk. Diese Option ist standardmäßig auf den von Festplattenspooler Greengrass bereitgestellten Wert eingestellt aws.greengrass.DiskSpooler und verwendet diesen.

Diese Funktion ist für Version 2.11.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: "aws.greengrass.DiskSpooler"

maxSizeInBytes

(Optional) Die maximale Größe des Caches, in dem das Kerngerät unverarbeitete MQTT-Nachrichten im Speicher speichert. Wenn der Cache voll ist, werden neue Nachrichten zurückgewiesen.

Standard: 2621440 (2,5 MB)

keepQos0WhenOffline

(Optional) Sie können MQTT QoS 0-Nachrichten spoolen, die das Kerngerät empfängt, während es offline ist. Wenn Sie diese Option auf setzentrue, spoolt das Kerngerät QoS 0-Nachrichten, die es nicht senden kann, während es offline ist. Wenn Sie diese Option auf setzenfalse, verwirft das Kerngerät diese Nachrichten. Das Core-Gerät spoolt immer QoS-1-Nachrichten, sofern der Spool nicht voll ist.

Standard: false

version

(Optional) Die Version von MQTT. Sie können entweder mqtt3 oder mqtt5 angeben.

Diese Funktion ist für Version 2.10.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: mqtt5

receiveMaximum

(Optional) Die maximale Anzahl unbestätigter QoS1-Pakete, die der Broker senden kann.

Diese Funktion ist für Version 2.10.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: 100

sessionExpirySeconds

(Optional) Die Dauer in Sekunden, die Sie für die Dauer einer Sitzung bei IoT Core anfordern können. Die Standardeinstellung ist die maximale Zeit, die von unterstützt wird AWS IoT Core.

Diese Funktion ist für Version 2.10.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: 604800 (7 days)

minimumReconnectDelaySeconds

(Optional) Eine Option für das Verhalten bei der Wiederverbindung. Die Mindestzeit in Sekunden, die MQTT benötigt, um die Verbindung wiederherzustellen.

Diese Funktion ist für Version 2.10.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: 1

maximumReconnectDelaySeconds

(Optional) Eine Option für das Verhalten bei der Wiederverbindung. Die maximale Zeit in Sekunden, für die MQTT die Verbindung wiederherstellt.

Diese Funktion ist für Version 2.10.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: 120

minimumConnectedTimeBeforeRetryResetSeconds

(Optional) Eine Option für das Verhalten bei der Wiederverbindung. Die Zeitspanne in Sekunden, die eine Verbindung aktiv sein muss, bevor die Wiederholungsverzögerung auf das Minimum zurückgesetzt wird.

Diese Funktion ist für Version 2.10.0 und höher der Greengrass Nucleus-Komponente verfügbar.

Standard: 30

jvmOptions

(Optional) Die JVM-Optionen, die zur Ausführung der Core-Software verwendet werden sollen. AWS IoT Greengrass Informationen zu den empfohlenen JVM-Optionen für die Ausführung der AWS IoT Greengrass Core-Software finden Sie unter. Steuern Sie die Speicherzuweisung mit JVM-Optionen

Wichtig

Wenn Sie eine Änderung an diesem Konfigurationsparameter bereitstellen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.

iotDataEndpoint

Der AWS IoT Datenendpunkt für Ihren AWS-Konto.

Wenn Sie die AWS IoT Greengrass Core-Software mit der --provision true Option ausführen, ruft die Software Ihre Daten und Anmeldeinformationen von den Endpunkten ab AWS IoT und legt sie in der Nucleus-Komponente fest.

iotCredEndpoint

Der Endpunkt für Ihre AWS IoT AWS-Konto Anmeldeinformationen.

Wenn Sie die AWS IoT Greengrass Core-Software mit der --provision true Option ausführen, ruft die Software Ihre Daten und Anmeldeinformationen von den Endpunkten ab AWS IoT und legt sie in der Nucleus-Komponente fest.

greengrassDataPlaneEndpoint

Diese Funktion ist in Version 2.7.0 und höher dieser Komponente verfügbar.

Weitere Informationen finden Sie unter Verwenden Sie ein Gerätezertifikat, das von einer privaten Zertifizierungsstelle signiert wurde.

greengrassDataPlanePort

Diese Funktion ist in Version 2.0.4 und höher dieser Komponente verfügbar.

(Optional) Der Port, der für Datenebenenverbindungen verwendet werden soll. Weitere Informationen finden Sie unter Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy.

Wichtig

Sie müssen einen Port angeben, über den das Gerät ausgehende Verbindungen herstellen kann. Wenn Sie einen Port angeben, der gesperrt ist, kann das Gerät keine Verbindung herstellen, um Bereitstellungen AWS IoT Greengrass zu empfangen.

Wählen Sie aus den folgenden Optionen aus:

  • 443

  • 8443

Standard: 8443

awsRegion

Der AWS-Region zu verwendende.

runWithDefault

Der Systembenutzer, der zum Ausführen von Komponenten verwendet werden soll.

Wichtig

Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.

Dieses Objekt enthält die folgenden Informationen:

posixUser

Der Name oder die ID des Systembenutzers und optional der Systemgruppe, die das Kerngerät verwendet, um generische Komponenten und Lambda-Komponenten auszuführen. Geben Sie den Benutzer und die Gruppe durch einen Doppelpunkt (:) getrennt im folgenden Format an: user:group. Die Gruppe ist optional. Wenn Sie keine Gruppe angeben, verwendet die AWS IoT Greengrass Core-Software die primäre Gruppe für den Benutzer. Sie können beispielsweise ggc_user oder ggc_user:ggc_group angeben. Weitere Informationen finden Sie unter Konfigurieren Sie den Benutzer, der die Komponenten ausführt.

Wenn Sie das AWS IoT Greengrass Core-Softwareinstallationsprogramm mit der --component-default-user ggc_user:ggc_group Option ausführen, legt die Software diesen Parameter in der Nucleus-Komponente fest.

windowsUser

Diese Funktion ist in Version 2.5.0 und höher dieser Komponente verfügbar.

Der Name des Windows-Benutzers, der für die Ausführung dieser Komponente auf Windows Core-Geräten verwendet werden soll. Der Benutzer muss auf jedem Windows Core-Gerät vorhanden sein, und sein Name und Passwort müssen in der Credentials Manager-Instanz des LocalSystem Kontos gespeichert sein. Weitere Informationen finden Sie unter Konfigurieren Sie den Benutzer, der die Komponenten ausführt.

Wenn Sie das AWS IoT Greengrass Core-Softwareinstallationsprogramm mit der --component-default-user ggc_user Option ausführen, legt die Software diesen Parameter in der Nucleus-Komponente fest.

systemResourceLimits

Diese Funktion ist in Version 2.4.0 und höher dieser Komponente verfügbar. AWS IoT Greengrass unterstützt diese Funktion derzeit nicht auf Windows Core-Geräten.

Die Systemressourcenlimits, die standardmäßig für generische und nicht containerisierte Lambda-Komponentenprozesse gelten sollen. Sie können die Systemressourcenlimits für einzelne Komponenten überschreiben, wenn Sie eine Bereitstellung erstellen. Weitere Informationen finden Sie unter Konfigurieren Sie die Systemressourcenlimits für Komponenten.

Dieses Objekt enthält die folgenden Informationen:

cpus

Die maximale Menge an CPU-Zeit, die die Prozesse der einzelnen Komponenten auf dem Kerngerät verwenden können. Die gesamte CPU-Zeit eines Core-Geräts entspricht der Anzahl der CPU-Kerne des Geräts. Auf einem Core-Gerät mit 4 CPU-Kernen können Sie diesen Wert beispielsweise auf festlegen, 2 um die Prozesse jeder Komponente auf 50 Prozent der Auslastung jedes CPU-Kerns zu beschränken. Auf einem Gerät mit einem CPU-Kern können Sie diesen Wert auf festlegen, 0.25 um die Prozesse jeder Komponente auf 25 Prozent der CPU-Auslastung zu beschränken. Wenn Sie diesen Wert auf eine Zahl festlegen, die größer als die Anzahl der CPU-Kerne ist, begrenzt die AWS IoT Greengrass Core-Software die CPU-Auslastung der Komponenten nicht.

memory

Die maximale Menge an RAM (in Kilobyte), die die Prozesse jeder Komponente auf dem Kerngerät verwenden können.

s3EndpointType

(Optional) Der S3-Endpunkttyp. Dieser Parameter gilt nur für die Region USA Ost (Nord-Virginia) (us-east-1). Die Einstellung dieses Parameters aus einer anderen Region wird ignoriert. Wählen Sie aus den folgenden Optionen aus:

  • REGIONAL— Der S3-Client und die vorsignierte URL verwenden den regionalen Endpunkt.

  • GLOBAL— Der S3-Client und die vorsignierte URL verwenden den Legacy-Endpunkt.

  • DUALSTACK— Die vorsignierte S3-URL verwendet den Dual-Stack-Endpunkt.

Standard: GLOBAL

fipsMode

(Optional) Veranlasst Greengrass, FIPS-Endpunkte zu verwenden. Weitere Informationen zur Aktivierung von FIPS-Endpunkten finden Sie unter FIPS-Endpunkte.

Wählen Sie aus den folgenden Optionen aus:

  • trueWenn die Einstellung auf true gesetzt ist, verwenden die Endgeräte den FIPS-Endpunkt.

  • falseWenn der Wert falsch ist, verwenden die Endpunkte keinen FIPS-Endpunkt.

Standard: false

logging

(Optional) Die Protokollierungskonfiguration für das Kerngerät. Weitere Informationen zur Konfiguration und Verwendung von Greengrass-Protokollen finden Sie unterAWS IoT Greengrass Protokolle überwachen.

Dieses Objekt enthält die folgenden Informationen:

level

(Optional) Die Mindestanzahl der auszugebenden Protokollmeldungen.

Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Standard: INFO

format

(Optional) Das Datenformat der Protokolle. Wählen Sie aus den folgenden Optionen aus:

  • TEXT— Wählen Sie diese Option, wenn Sie Protokolle in Textform anzeigen möchten.

  • JSON— Wählen Sie diese Option, wenn Sie Protokolle mit dem Greengrass-CLI-Befehl logs anzeigen oder programmgesteuert mit Protokollen interagieren möchten.

Standard: TEXT

outputType

(Optional) Der Ausgabetyp für Protokolle. Wählen Sie aus den folgenden Optionen aus:

  • FILE— Die AWS IoT Greengrass Core-Software gibt Protokolle in Dateien in dem Verzeichnis aus, das Sie angebenoutputDirectory.

  • CONSOLE— Die AWS IoT Greengrass Core-Software druckt Protokolle instdout. Wählen Sie diese Option, um Protokolle anzuzeigen, während das Core-Gerät sie druckt.

Standard: FILE

fileSizeKB

(Optional) Die maximale Größe jeder Protokolldatei (in Kilobyte). Wenn eine Protokolldatei diese maximale Dateigröße überschreitet, erstellt die AWS IoT Greengrass Core-Software eine neue Protokolldatei.

Dieser Parameter gilt nur, wenn Sie FILE für angebenoutputType.

Standard: 1024

totalLogsSizeKB

(Optional) Die maximale Gesamtgröße der Protokolldateien (in Kilobyte) für jede Komponente, einschließlich des Greengrass-Kerns. Die Protokolldateien von Greengrass Nucleus enthalten auch Protokolle von Plugin-Komponenten. Wenn die Gesamtgröße der Protokolldateien einer Komponente diese maximale Größe überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.

Dieser Parameter entspricht dem Parameter für die Speicherplatzbeschränkung (diskSpaceLimit) der Log Manager-Komponente, den Sie für den Greengrass-Kern (System) und jede Komponente angeben können. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für den Greengrass-Kern und jede Komponente.

Dieser Parameter gilt nur, wenn Sie FILE für outputType angeben.

Standard: 10240

outputDirectory

(Optional) Das Ausgabeverzeichnis für Protokolldateien.

Dieser Parameter gilt nur, wenn Sie FILE für angebenoutputType.

Standard:/greengrass/v2/logs, wo /greengrass/v2 ist der AWS IoT Greengrass Stammordner.

fleetstatus

Dieser Parameter ist in Version 2.1.0 und höher dieser Komponente verfügbar.

(Optional) Die Flottenstatuskonfiguration für das Kerngerät.

Dieses Objekt enthält die folgenden Informationen:

periodicStatusPublishIntervalSeconds

(Optional) Der Zeitraum (in Sekunden), zwischen dem das Kerngerät den Gerätestatus an den veröffentlicht AWS Cloud.

Minimum: 86400 (24 Stunden)

Standard: 86400 (24 Stunden)

telemetry

(Optional) Die Konfiguration der Systemintegritäts-Telemetrie für das Kerngerät. Weitere Informationen zu Telemetriemetriken und dazu, wie Sie mit Telemetriedaten umgehen können, finden Sie unter. Erfassung von Telemetriedaten zur Systemintegrität von AWS IoT Greengrass Kerngeräten

Dieses Objekt enthält die folgenden Informationen:

enabled

(Optional) Sie können Telemetrie aktivieren oder deaktivieren.

Standard: true

periodicAggregateMetricsIntervalSeconds

(Optional) Das Intervall (in Sekunden), über das das Kerngerät Metriken aggregiert.

Wenn Sie diesen Wert unter den unterstützten Mindestwert setzen, verwendet der Nucleus stattdessen den Standardwert.

Minimum: 3600

Standard: 3600

periodicPublishMetricsIntervalSeconds

(Optional) Der Zeitraum (in Sekunden), zwischen dem das Kerngerät Telemetriedaten an den AWS Cloud veröffentlicht.

Wenn Sie diesen Wert unter den unterstützten Mindestwert einstellen, verwendet der Nucleus stattdessen den Standardwert.

Minimum: 86400

Standard: 86400

deploymentPollingFrequencySeconds

(Optional) Der Zeitraum in Sekunden, für den Bereitstellungsbenachrichtigungen abgefragt werden sollen.

Standard: 15

componentStoreMaxSizeBytes

(Optional) Die maximale Größe des Komponentenspeichers auf der Festplatte, der Komponentenrezepte und Artefakte umfasst.

Standard: 10000000000 (10 GB)

platformOverride

(Optional) Ein Wörterbuch mit Attributen, die die Plattform des Kerngeräts identifizieren. Verwenden Sie dies, um benutzerdefinierte Plattformattribute zu definieren, anhand derer Komponentenrezepte den richtigen Lebenszyklus und die richtigen Artefakte für die Komponente identifizieren können. Sie können beispielsweise ein Hardwarefähigkeitsattribut definieren, um nur die minimale Menge an Artefakten bereitzustellen, die für die Ausführung einer Komponente erforderlich sind. Weitere Informationen finden Sie unter dem Plattformparameter Manifest im Komponentenrezept.

Sie können diesen Parameter auch verwenden, um die os und die architecture Plattformattribute des Kerngeräts zu überschreiben.

httpClient

Dieser Parameter ist in Version 2.5.0 und höher dieser Komponente verfügbar.

(Optional) Die HTTP-Client-Konfiguration für das Kerngerät. Diese Konfigurationsoptionen gelten für alle HTTP-Anfragen, die von dieser Komponente gestellt werden. Wenn ein Core-Gerät in einem langsameren Netzwerk läuft, können Sie diese Timeout-Dauern erhöhen, um zu verhindern, dass bei HTTP-Anfragen ein Timeout auftritt.

Dieses Objekt enthält die folgenden Informationen:

connectionTimeoutMs

(Optional) Die Zeitspanne (in Millisekunden), die auf das Öffnen einer Verbindung gewartet werden soll, bevor bei der Verbindungsanforderung ein Timeout eintritt.

Standard: 2000 (2 Sekunden)

socketTimeoutMs

(Optional) Die Zeitspanne (in Millisekunden), die auf die Übertragung von Daten über eine offene Verbindung gewartet werden soll, bevor bei der Verbindung ein Timeout eintritt.

Standard: 30000 (30 Sekunden)

Beispiel: Aktualisierung der Konfigurationszusammenführung
{
  "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias",
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "http://my-proxy-server:1100",
      "username": "Mary_Major",
      "password": "pass@word1357"
    }
  },
  "mqtt": {
    "port": 443
  },
  "greengrassDataPlanePort": 443,
  "jvmOptions": "-Xmx64m",
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Um die Protokolle dieser Komponente einzusehen

  • Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. Ersetzen Sie /greengrass/v2 oder C:\greengrass\v2 durch den Pfad zum AWS IoT Greengrass Stammordner.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.

Version

Änderungen

2.14.1

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem Komponenten bei Neuinstallationen von Greengrass nicht richtig gestoppt wurden.

2.14.0
Warnung

Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.

Neue Features

  • Die neue Unterstützung von Dual-Stack-Endpunkten ermöglicht die IPv6 Netzwerkkommunikation.

  • Verbesserte Widerstandsfähigkeit gegen Nucleus-Neustartfehler und Launch Verzeichnisbeschädigung.

Fehlerkorrekturen und Verbesserungen

  • Behebt Speicherlecks bei Schließungen von PubSub IPC-Abonnements.

  • Behebt den Ausführungslebenszyklus der Komponente, bei der sie aufgrund eines Start-Timeouts in den Status ERRORED übergeht, wenn die Skipif-Bedingung erfüllt ist.

  • Behebt ein Problem, bei dem das Core-Gerät keine Verbindung herstellen kann, AWS IoT Core wenn die TLS-Richtlinie auf _1_3_2022_10 gesetzt ist. TLS13

2.13.0
Neue Features

  • Support den FIPS-Endpunkt in Nucleus.

Fehlerkorrekturen und Verbesserungen

  • Bereitstellungsverbesserungen abbrechen: Bereitstellungen können jetzt abgebrochen werden, während eine neue Konfiguration zusammengeführt wird und auf den Start der Dienste gewartet wird.

2.12.6
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, das bei bestimmten ARMv8 Prozessoren, einschließlich des Jetson Nano, beim Start zu einem Absturz führt.

2.12.5
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem das Rollback der Bereitstellung gelegentlich hängen bleibt, wenn eine zuvor defekte Komponente mit festen Abhängigkeiten zurückgesetzt wird.

  • Behebt ein Problem, bei dem der Nucleus nach der Flottenbereitstellung keine Status-Updates veröffentlicht.

  • Fügt Wiederholungsversuche für die GetDeploymentConfiguration API hinzu, nachdem 404-Fehler aufgetreten sind.

2.12.4
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem der Nucleus beim Start auf einigen Linux-Geräten in einen Deadlock-Zustand gerät.

2.12.3
Warnung

Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem der Nucleus nach dem Neustart des Nucleus und während der Wiederherstellung der Komponenten nicht den korrekten Komponentenstatus meldet.

  • Allgemeine Fehlerbehebungen und Verbesserungen.

2.12.2
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem alte Logs nicht richtig bereinigt wurden.

  • Allgemeine Fehlerbehebungen und Verbesserungen.

2.12.1
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem der Nucleus MQTT-Abonnements für Bereitstellungsthemen duplizieren kann, was zu zusätzlicher Protokollierung und MQTT-Veröffentlichung führt.

2.12.0
Neue Features

  • Ermöglicht es Ihnen, die Bootstrap-Lebenszyklusschritte als Teil einer Rollback-Bereitstellung auszuführen.

2.11.3
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem im Nucleus, bei dem eine Komponente möglicherweise falsch gestartet wird, wenn ihre Abhängigkeiten fehlschlagen.

Neue Features

  • Fügt den konfigurierbaren S3-Endpunkttyp hinzu.

2.11.2
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem im Nucleus MQTT 5-Client, bei dem er offline angezeigt werden kann, wenn eine große Anzahl (> 50) von Abonnements verwendet wird.

  • Fügt einen erneuten Versuch für den Docker-Dial-TCP-Fehler hinzu.

2.11.1
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem der Nucleus nicht startet, wenn eine Bootstrap-Aufgabe fehlschlägt und die Deployment-Metadatendatei beschädigt ist.

  • Behebt ein Problem, bei dem On-Demand-Lambda-Komponenten in Statusaktualisierungen für die Bereitstellung nicht gemeldet werden.

  • Fügt Unterstützung für doppelte Autorisierungsrichtlinien IDs hinzu.

2.11.0
Neue Features

  • Ermöglicht es Ihnen, eine lokale Bereitstellung abzubrechen.

  • Ermöglicht die Konfiguration einer Fehlerbehandlungsrichtlinie für eine lokale Bereitstellung.

  • Fügt Unterstützung für ein Disk-Spooler-Plugin hinzu.

2.10.3
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem Greengrass keine Bereitstellungsbenachrichtigungen abonniert, wenn der PKCS #11 -Anbieter verwendet wird.

2.10.2
Fehlerkorrekturen und Verbesserungen

  • Ermöglicht die Analyse von Komponenten-Lebenszyklen ohne Berücksichtigung der Groß- und Kleinschreibung.

  • Behebt ein Problem, bei dem die Umgebungsvariable PATH nicht korrekt neu erstellt wurde.

  • Behebt die Proxy-URI-Kodierung für Komponenten, einschließlich des Stream-Managers für Benutzernamen mit Sonderzeichen.

2.10.1
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, das bei bestimmten ARMv8 Prozessoren, einschließlich des Jetson Nano, zu einem Absturz beim Start führen konnte.

  • Greengrass schließt den Standard einer Komponente nicht mehr, dadurch wird das Verhalten auf das Verhalten vor 2.10.0 zurückgesetzt

2.10.0
Neue Features

  • Fügt interpolateComponentConfiguration Unterstützung für den leeren regulären Ausdruck hinzu. Greengrass interpoliert jetzt vom Root-Konfigurationsobjekt aus.

  • Fügt Unterstützung für hinzu. MQTT5

  • Fügt einen Mechanismus hinzu, mit dem Plugin-Komponenten schnell und ohne Scannen geladen werden können.

  • Ermöglicht Greengrass, Speicherplatz zu sparen, indem unbenutzte Docker-Images gelöscht werden.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem beim Rollback bestimmte Konfigurationswerte aus einer Bereitstellung beibehalten werden.

  • Behebt ein Problem, bei dem der Greengrass-Nucleus nach einer AWS Domain-Sequenz in benutzerdefinierten AWS Nicht-Credentials und Datenendpunkten validiert.

  • Aktualisiert die Auflösung von Abhängigkeiten mehrerer Gruppen, sodass alle Gruppenabhängigkeiten per AWS Cloud Aushandlung erneut aufgelöst werden, anstatt sich an die aktive Version zu binden. Mit diesem Update wird auch der Bereitstellungsfehlercode entfernt. INSTALLED_COMPONENT_NOT_FOUND

  • Aktualisiert den Greengrass-Kern, sodass das Herunterladen von Docker-Images übersprungen wird, wenn sie bereits lokal vorhanden sind.

  • Aktualisiert den Greengrass-Nucleus so, dass er einen Komponenteninstallationsschritt neu startet, bevor das Timeout abläuft.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.9.6
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem eine Greengrass-Bereitstellung mit dem Fehler LAUNCH_DIRECTORY_CORRUPTED fehlschlägt und Greengrass bei einem nachfolgenden Geräteneustart nicht gestartet werden kann. Dieser Fehler kann auftreten, wenn Sie das Greengrass-Gerät zwischen mehreren Dinggruppen mit Bereitstellungen verschieben, für die Greengrass neu gestartet werden muss.

2.9.5
Neue Features

  • Fügt Unterstützung für die Überprüfung der Greengrass Nucleus-Software hinzu.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem eine Bereitstellung fehlschlägt, wenn die lokale Rezept-Metadatenregion nicht mit der Greengrass Nucleus-Startregion übereinstimmt. Wenn das passiert, verhandelt der Greengrass-Kern nun neu mit der Cloud.

  • Behebt ein Problem, bei dem der MQTT-Nachrichtenspooler Nachrichten füllt und sie nie löscht.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.9.4
Fehlerkorrekturen und Verbesserungen

  • Prüft, ob eine Null-Nachricht vorliegt, bevor QOS 0-Nachrichten gelöscht werden.

  • Kürzt die Detailwerte für den Auftragsstatus, wenn sie das Limit von 1024 Zeichen überschreiten.

  • Aktualisiert das Bootstrap-Skript für Windows, sodass es den Greengrass-Stammpfad korrekt liest, falls dieser Pfad Leerzeichen enthält.

  • Aktualisiert das Abonnement, AWS IoT Core sodass Kundennachrichten gelöscht werden, wenn die Abonnementantwort nicht gesendet wurde.

  • Stellt sicher, dass der Nucleus seine Konfiguration aus Backup-Dateien lädt, wenn die Hauptkonfigurationsdatei beschädigt ist oder fehlt.

2.9.3
Fehlerkorrekturen und Verbesserungen

  • Stellt sicher, dass MQTT-Clients IDs nicht dupliziert werden.

  • Fügt robusteres Lesen und Schreiben von Dateien hinzu, um Beschädigungen zu vermeiden und diese wiederherzustellen.

  • Wiederholt den Docker-Image-Pull bei bestimmten Netzwerkfehlern.

  • Fügt die noProxyAddresses Option für eine MQTT-Verbindung hinzu.

2.9.2
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem die Konfiguration interpolateComponentConfiguration nicht für eine laufende Bereitstellung gilt.

  • Verwendet OSHI, um alle untergeordneten Prozesse aufzulisten.

2.9.1
Fehlerkorrekturen und Verbesserungen

  • Fügt einen Fix hinzu, bei dem Greengrass neu startet, wenn eine Bereitstellung eine Plugin-Komponente entfernt.

2.9.0
Neue Features

  • Fügt die Möglichkeit hinzu, Unterbereitstellungen zu erstellen, die Bereitstellungen mit einer kleineren Teilmenge von Geräten wiederholen. Diese Funktion ermöglicht eine effizientere Methode zum Testen und Beheben fehlgeschlagener Bereitstellungen.

Fehlerkorrekturen und Verbesserungen

  • Verbessert die Unterstützung für Systeme, die nicht über useraddgroupadd, und verfügenusermod.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.8.1
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem Bereitstellungsfehlercodes aufgrund von Greengrass-API-Fehlern nicht korrekt generiert wurden.

  • Behebt ein Problem, bei dem Aktualisierungen des Flottenstatus ungenaue Informationen senden, wenn eine Komponente während eines Einsatzes einen ERRORED bestimmten Status erreicht.

  • Behebt ein Problem, bei dem Bereitstellungen nicht abgeschlossen werden konnten, wenn Greengrass über mehr als 50 bestehende Abonnements verfügte.

2.8.0
Neue Features

  • Aktualisiert den Greengrass-Nucleus so, dass er eine Antwort auf den Bereitstellungsstatus meldet, die detaillierte Fehlercodes enthält, wenn bei der Bereitstellung von Komponenten auf einem Kerngerät ein Problem auftritt. Weitere Informationen finden Sie unter Detaillierte Fehlercodes für die Bereitstellung.

  • Aktualisiert den Greengrass-Kern so, dass er eine Antwort auf den Komponentenstatus meldet, die detaillierte Fehlercodes enthält, wenn eine Komponente in den ERRORED Status BROKEN oder wechselt. Weitere Informationen finden Sie unter Detaillierte Statuscodes für Komponenten.

  • Erweitert die Felder für Statusmeldungen, um die Informationen zur Cloud-Verfügbarkeit für Geräte zu verbessern.

  • Verbessert die Robustheit der Dienste für den Flottenstatus.

Fehlerkorrekturen und Verbesserungen

  • Ermöglicht die Neuinstallation einer defekten Komponente, wenn sich ihre Konfiguration ändert.

  • Behebt ein Problem, bei dem ein Nucleus-Neustart während der Bootstrap-Bereitstellung dazu führt, dass eine Bereitstellung fehlschlägt.

  • Behebt ein Problem in Windows, bei dem die Installation fehlschlägt, wenn ein Stammpfad Leerzeichen enthält.

  • Behebt ein Problem, bei dem eine Komponente, die während einer Bereitstellung heruntergefahren wird, das Shutdown-Skript der neuen Version verwendet.

  • Verschiedene Verbesserungen beim Herunterfahren.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.7.0
Neue Features

  • Aktualisiert den Greengrass-Nucleus, sodass Status-Updates an die AWS IoT Greengrass Cloud gesendet werden, wenn das Kerngerät eine lokale Bereitstellung anwendet.

  • Integriert die Unterstützung für Client-Zertifikate, die von einer benutzerdefinierten Zertifizierungsstelle (CA) signiert wurden, bei der die CA nicht registriert ist. AWS IoT Um diese Funktion zu verwenden, können Sie die neue greengrassDataPlaneEndpoint Konfigurationsoption auf einstelleniotdata. Weitere Informationen finden Sie unter Verwenden Sie ein Gerätezertifikat, das von einer privaten Zertifizierungsstelle signiert wurde.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem der Greengrass Nucleus eine Bereitstellung in bestimmten Szenarien rückgängig macht, wenn der Nucleus gestoppt oder neu gestartet wird. Der Nucleus nimmt den Einsatz jetzt wieder auf, nachdem der Nucleus neu gestartet wurde.

  • Aktualisiert das Greengrass-Installationsprogramm so, dass es das --start Argument berücksichtigt, wenn Sie angeben, dass die Software als Systemdienst eingerichtet werden soll.

  • Aktualisiert das Verhalten von SubscribeToComponentUpdates zum Einstellen der Bereitstellungs-ID bei Ereignissen, bei denen der Nucleus eine Komponente aktualisiert hat.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.6.0
Neue Features
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem abhängige Komponenten in bestimmten Szenarien nicht reagierten, wenn ihre festen Abhängigkeiten neu gestartet wurden oder ihren Status änderten.

  • Verbessert die Fehlermeldungen, die das Kerngerät an den AWS IoT Greengrass Cloud-Dienst meldet, wenn eine Bereitstellung fehlschlägt.

  • Behebt ein Problem, bei dem der Greengrass-Kern in bestimmten Szenarien beim Neustart des Nucleus zweimal eine Ding-Bereitstellung durchgeführt hat.

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

2.5.6
Neue Features

  • Integriert die Unterstützung für Hardware-Sicherheitsmodule, die ECC-Schlüssel verwenden. Sie können ein Hardware-Sicherheitsmodul (HSM) verwenden, um den privaten Schlüssel und das Zertifikat des Geräts sicher zu speichern. Weitere Informationen finden Sie unter Integration von Hardware-Sicherheit.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem die Bereitstellung nie abgeschlossen wird, wenn Sie in bestimmten Szenarien eine Komponente mit einem defekten Installationsskript bereitstellen.

  • Verbessert die Leistung beim Start.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.5.5
Neue Features

  • Fügt die GG_ROOT_CA_PATH Umgebungsvariable für Komponenten hinzu, sodass Sie in benutzerdefinierten Komponenten auf das Zertifikat der Stammzertifizierungsstelle (CA) zugreifen können.

Fehlerkorrekturen und Verbesserungen

  • Integriert die Unterstützung für Windows-Geräte, die eine andere Anzeigesprache als Englisch verwenden.

  • Aktualisiert die Art und Weise, wie der Greengrass-Nucleus boolesche Installer-Argumente analysiert, sodass Sie ein boolesches Argument ohne einen booleschen Wert angeben können, um einen Wert anzugeben. true Beispielsweise können Sie jetzt angeben, dass die Installation --provision statt der automatischen Ressourcenbereitstellung erfolgen soll. --provision true

  • Behebt ein Problem, bei dem das Kerngerät in bestimmten Szenarien seinen Status nach der Bereitstellung nicht an den AWS IoT Greengrass Cloud-Dienst gemeldet hat.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.5.4
Fehlerkorrekturen und Verbesserungen

  • Allgemeine Fehlerbehebungen und Verbesserungen.

2.5.3
Neue Features

  • Fügt Unterstützung für die Hardware-Sicherheitsintegration hinzu. Sie können ein Hardware-Sicherheitsmodul (HSM) verwenden, um den privaten Schlüssel und das Zertifikat des Geräts sicher zu speichern. Weitere Informationen finden Sie unter Integration von Hardware-Sicherheit.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem mit Laufzeitausnahmen, während der Nucleus MQTT-Verbindungen mit AWS IoT Core herstellt.

2.5.2
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, bei dem der Windows-Dienst nach dem Greengrass Nucleus-Update nicht erneut gestartet werden kann, nachdem Sie ihn gestoppt oder das Gerät neu gestartet haben.

2.5.1
Warnung

Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.

Fehlerkorrekturen und Verbesserungen

  • Integriert die Unterstützung für 32-Bit-Versionen des Java Runtime Environment (JRE) unter Windows.

  • Ändert das Verhalten beim Entfernen von Dinggruppen für Kerngeräte, deren AWS IoT Richtlinie diese greengrass:ListThingGroupsForCoreDevice Berechtigung nicht erteilt. Bei dieser Version wird die Bereitstellung fortgesetzt, es wird eine Warnung protokolliert und es werden keine Komponenten entfernt, wenn Sie das Kerngerät aus einer Dinggruppe entfernen. Weitere Informationen finden Sie unter AWS IoT Greengrass Komponenten auf Geräten bereitstellen.

  • Behebt ein Problem mit Systemumgebungsvariablen, die der Greengrass-Kern für Greengrass-Komponentenprozesse zur Verfügung stellt. Sie können eine Komponente jetzt neu starten, damit sie die neuesten Systemumgebungsvariablen verwendet.

2.5.0
Neue Features
Fehlerkorrekturen und Verbesserungen

  • Behebt die Bootstrap-Lebenszyklusoption, um das Kerngerät von einer Komponente aus neu zu starten.

  • Fügt Unterstützung für Bindestriche in Rezeptvariablen hinzu.

  • Behebt die IPC-Autorisierung für On-Demand-Lambda-Funktionskomponenten.

  • Verbessert die Protokollmeldungen und ändert unkritische Protokolle von einer DEBUG Ebene INFO zur nächsten, sodass Protokolle nützlicher sind.

  • Entfernt die iot:DescribeCertificate Berechtigung aus der standardmäßigen Token-Austauschrolle, die der Greengrass-Nucleus erstellt, wenn Sie die AWS IoT Greengrass Core-Software mit automatischer Bereitstellung installieren. Diese Erlaubnis wird vom Greengrass-Kern nicht verwendet.

  • Behebt ein Problem, sodass das automatische Bereitstellungsskript die iam:GetPolicy Genehmigung nicht benötigt, wenn iam:CreatePolicy es für dieselbe Richtlinie verfügbar ist.

  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.4.0
Neue Features
Fehlerkorrekturen und Verbesserungen

  • Aktualisiert die Protokollierungskonfiguration beim Start. Dies behebt ein Problem, bei dem die Protokollierungskonfiguration beim Start nicht angewendet wurde.

  • Aktualisiert den Nucleus-Loader-Symlink so, dass er während der Installation auf den Komponentenspeicher im Greengrass-Stammordner verweist. Mit diesem Update können Sie die JAR-Datei und andere Nucleus-Artefakte löschen, die Sie bei der Installation der AWS IoT Greengrass Core-Software herunterladen.

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

2.3.0
Neue Features

  • Fügt die iot:thingName Rezeptvariable hinzu. Sie können diese Rezeptvariable verwenden, um den Namen der AWS IoT Sache des Kerngeräts in einem Rezept abzurufen. Weitere Informationen finden Sie unter Rezeptvariablen.

Fehlerkorrekturen und Verbesserungen

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

2.2.0
Neue Features

  • Fügt IPC-Operationen für die lokale Schattenverwaltung hinzu.

Fehlerkorrekturen und Verbesserungen

  • Reduziert die Größe der JAR-Datei.

  • Reduziert den Speicherverbrauch.

  • Behebt Probleme, bei denen die Protokollkonfiguration in bestimmten Fällen nicht aktualisiert wurde.

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

2.1.0
Neue Features

  • Unterstützt das Herunterladen von Docker-Images aus privaten Repositorys in Amazon ECR.

  • Fügt die folgenden Parameter hinzu, um die MQTT-Konfiguration auf Kerngeräten anzupassen:

    • maxInFlightPublishes— Die maximale Anzahl unbestätigter MQTT QoS 1-Nachrichten, die gleichzeitig gesendet werden können.

    • maxPublishRetry— Die maximale Anzahl an Wiederholungen einer Nachricht, die nicht veröffentlicht werden kann.

  • Fügt den fleetstatusservice Konfigurationsparameter hinzu, um das Intervall zu konfigurieren, in dem das Kerngerät den Gerätestatus für veröffentlicht. AWS Cloud

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, das dazu führte, dass Shadow-Bereitstellungen dupliziert wurden, wenn der Nucleus neu gestartet wurde.

  • Behebt ein Problem, das dazu führte, dass der Nucleus abstürzte, wenn er auf eine Service-Load-Ausnahme stieß.

  • Verbessert die Auflösung von Komponentenabhängigkeiten, sodass eine Bereitstellung fehlschlägt, die eine zirkuläre Abhängigkeit enthält.

  • Behebt ein Problem, das die erneute Bereitstellung einer Plugin-Komponente verhinderte, wenn diese Komponente zuvor vom Kerngerät entfernt worden war.

  • Behebt ein Problem, das dazu führte, dass die HOME Umgebungsvariable auf das /greengrass/v2/work Verzeichnis für Lambda-Komponenten oder für Komponenten gesetzt wurde, die als Root ausgeführt werden. Die HOME Variable ist jetzt korrekt auf das Home-Verzeichnis des Benutzers gesetzt, der die Komponente ausführt.

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

2.0.5
Fehlerkorrekturen und Verbesserungen

  • Leitet den Datenverkehr beim Herunterladen von AWS bereitgestellten Komponenten korrekt über einen konfigurierten Netzwerk-Proxy weiter.

  • Verwenden Sie den richtigen Endpunkt der Greengrass-Datenebene in AWS China Regionen.

2.0.4
Neue Features

  • Aktiviert HTTPS-Verkehr über Port 443. Sie können den neuen greengrassDataPlanePort Konfigurationsparameter für Version 2.0.4 der Nucleus-Komponente verwenden, um die HTTPS-Kommunikation so zu konfigurieren, dass sie über Port 443 statt über den Standardport 8443 übertragen wird. Weitere Informationen finden Sie unter Konfigurieren Sie HTTPS über Port 443.

  • Fügt die Rezeptvariable für den Arbeitspfad hinzu. Sie können diese Rezeptvariable verwenden, um den Pfad zu den Arbeitsordnern der Komponenten abzurufen, die Sie verwenden können, um Dateien zwischen Komponenten und ihren Abhängigkeiten gemeinsam zu nutzen. Weitere Informationen finden Sie in der Rezeptvariablen für den Arbeitspfad.

Fehlerkorrekturen und Verbesserungen

  • Verhindert die Erstellung der AWS Identity and Access Management Token-Exchange-Rollenrichtlinie (IAM), wenn bereits eine Rollenrichtlinie existiert.

    Aufgrund dieser Änderung benötigt das Installationsprogramm nun iam:GetPolicy und, sts:GetCallerIdentity wenn es mit --provision true ausgeführt wird. Weitere Informationen finden Sie unter Minimale IAM-Richtlinie für das Installationsprogramm zur Bereitstellung von Ressourcen.

  • Behandelt die Stornierung einer Bereitstellung, die noch nicht erfolgreich registriert wurde, korrekt.

  • Aktualisiert die Konfiguration, sodass beim Rollback einer Bereitstellung ältere Einträge mit neueren Zeitstempeln entfernt werden.

  • Zusätzliche kleinere Korrekturen und Verbesserungen. Weitere Informationen finden Sie in den Veröffentlichungen unter GitHub.

2.0.3

Erste Version