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üngras-Kern
Die Greengrass-Nucleus-Komponente (aws.greengrass.Nucleus) ist eine obligatorische Komponente und die Mindestanforderung für die Ausführung der AWS IoT Greengrass Core-Software auf einem Gerät. Sie können diese Komponente so konfigurieren, dass Sie Ihre AWS IoT Greengrass Core-Software aus der Ferne anpassen und aktualisieren können. Stellen Sie diese Komponente bereit, um Einstellungen wie Proxy, Geräterolle und AWS IoT Dingkonfiguration auf Ihren Kerngeräten zu konfigurieren.
Anmerkung
Ab Greengrass-Version 2.14.0 ist eine für den Speicherbedarf optimierte Version der Nucleus-Gerätelaufzeit für Edge-Geräte mit eingeschränkten Einschränkungen verfügbar. Weitere Informationen zu seiner 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 — die den Nucleus und alle anderen Komponenten auf Ihrem Gerät umfasst — neu gestartet, um die Änderungen zu übernehmen.
Wenn Sie eine Komponente bereitstellen, AWS IoT Greengrass installiert sie die neuesten unterstützten Versionen aller Abhängigkeiten dieser Komponente. Aus diesem Grund werden neue Patch-Versionen der von AWS uns bereitgestellten öffentlichen Komponenten möglicherweise automatisch auf Ihren Kerngeräten bereitgestellt, wenn Sie einer Dinggruppe neue Geräte hinzufügen oder 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 von Bereitstellungen erstellen. Weitere Informationen zum Aktualisierungsverhalten der AWS IoT Greengrass Core-Software finden Sie unterAktualisieren Sie das AWS IoT Greengrass Kernsoftware (OTA).
Themen
Versionen
Diese Komponente hat die folgenden Versionen:
-
2.18.x
-
2.17.x
-
2.16.x
-
2.15.x
-
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
Sie können AWS IoT Device Tester for verwenden, AWS IoT Greengrass um zu überprüfen, ob Ihr Gerät die AWS IoT Greengrass Core-Software ausführen und mit dem AWS Cloud kommunizieren kann. Weitere Informationen finden Sie unter Verwenden AWS IoT Device Tester for AWS IoT Greengrass V2.
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 enthalten sind, funktionieren möglicherweise, aber AWS IoT Greengrass Tests nur auf diesen angegebenen Plattformen.
Überlegungen zu Funktionen
Einige AWS IoT Greengrass Funktionen werden derzeit auf Windows-Geräten nicht unterstützt. Überprüfen Sie die Funktionsunterschiede, um sicherzustellen, dass ein Windows-Gerät Ihre Anforderungen erfüllt. Weitere Informationen finden Sie unter Kompatibilität der Greengrass-Funktionen.
Um ein benutzerdefiniertes Linux-based Betriebssystem zu erstellen, können Sie das BitBake Rezept für AWS IoT Greengrass
im meta-aws Projekt meta-aws Projekt bietet Rezepte, mit denen Sie AWS Edge-Softwarefunktionen in eingebetteten
Linux-Plattformen können auch AWS IoT Greengrass 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.
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 zu installieren und auszuführen. 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 enthält keine Komponentenabhängigkeiten. Allerdings enthalten mehrere von AWS ihm bereitgestellte Komponenten den Nucleus als Abhängigkeit. Weitere Informationen finden Sie unter AWS-mitgelieferte Komponenten.
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Komponentenrezeptreferenz.
Herunterladen und Installieren
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 Nucleus zu installieren und die Entwicklung von Greengrass-Komponenten kennenzulernen. 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 erfordern einen Neustart der AWS IoT Greengrass Core-Software, damit sie wirksam werden. Weitere Informationen darüber, warum und wie diese Komponente konfiguriert werden muss, finden Sie unterKonfigurieren Sie den AWS IoT Greengrass Kernsoftware.
iotRoleAliasDer AWS IoT Rollenalias, der auf eine Token Exchange-IAM-Rolle verweist. Der AWS IoT Anmeldeinformationsanbieter ü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 der
--provision trueOption ausführen, stellt die Software einen Rollenalias bereit und legt seinen Wert in der Nucleus-Komponente fest.-
interpolateComponentConfiguration -
(Optional) Sie können den Greengrass-Nukleus so einrichten, dass Rezeptvariablen für Komponenten in Komponentenkonfigurationen interpoliert und Konfigurationsaktualisierungen zusammengeführt werden. Wir empfehlen, diese Option auf einzustellen,
truedamit 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 Format
scheme://userinfo@host:port.-
scheme— Das Schema, dashttpoder 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 Felderusernameundpassword. -
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
PINGNachrichten, die der Client sendet, um die MQTT-Verbindung aufrechtzuerhalten. Dieser Wert muss größer als sein.pingTimeoutMsStandard:
60000(60 Sekunden) pingTimeoutMs-
(Optional) Die Zeitspanne in Millisekunden, die der Client auf den Empfang einer
PINGACKNachricht vom Server wartet. Wenn die Wartezeit den Timeout überschreitet, schließt das Kerngerät die MQTT-Verbindung und öffnet sie erneut. Dieser Wert muss kleiner als sein.keepAliveTimeoutMsStandard:
30000(30 Sekunden) operationTimeoutMs-
(Optional) Die Zeitspanne in Millisekunden, die der Client auf den Abschluss von MQTT-Vorgängen (wie
CONNECToder) wartet.PUBLISHDiese Option gilt nicht fürPINGMQTT- 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:
5Gültiger Bereich: Maximalwert von 100
maxMessageSizeInBytes-
(Optional) Die maximale Größe einer MQTT-Nachricht. Wenn eine Nachricht diese Größe überschreitet, weist der Greengrass-Nukleus die Nachricht mit einem Fehler zurück.
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, die nicht veröffentlicht werden kann, maximal wiederholt werden soll. Sie können angeben
-1, dass der Vorgang unbegrenzt oft wiederholt werden soll.Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.
Standard:
100 standaloneMqttTimeoutMs-
(Optional) Die Zeit in Millisekunden, die der Nucleus während des IoT-Connectivity-Switches auf eigenständige MQTT-Verbindungen wartet. Dieser Timeout deckt die Konnektivitätsprüfung vor dem Flug und den Statusbericht ab, den der Nucleus nach einem erfolgreichen Wechsel an das Quellkonto sendet.
Für diese Funktion ist Version 2.18.0 oder höher dieser Komponente erforderlich.
Standard:
60000(60 Sekunden)Gültiger Bereich: Mindestwert von 1
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 gesetzt
storageTypeistDisk,pluginNamekann der konfiguriert werden. Sie können entwederMemoryoderDiskangeben.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
storageTypeistDiskund Sie Greengrass Nucleus von Version 2.11.x auf eine frühere Version herunterstufen möchten, müssen Sie die Konfiguration wieder auf ändern.MemoryDie einzige Konfiguration dafürstorageType, die in den Greengrass Nucleus-Versionen 2.10.x und früher unterstützt wird, ist.MemoryWenn Sie diese Anleitung nicht befolgen, kann dies 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 CloudStandard:
Memory pluginName-
(Optional) Der Name der Plugin-Komponente. Diese Komponente wird nur verwendet, wenn sie auf gesetzt
storageTypeistDisk. Diese Option ist standardmäßig auf eingestelltaws.greengrass.DiskSpoolerund verwendet die Greengrass-provided Festplattenspooler.Diese Funktion ist für Version 2.11.0 und höher der Greengrass Nucleus-Komponente verfügbar. Grüngras-Kern
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 abgelehnt.
Standard:
2621440(2,5 MB) keepQos0WhenOffline-
(Optional) Sie können MQTT QoS 0-Nachrichten spoolen, die das Core-Gerät empfängt, während es offline ist. Wenn Sie diese Option auf setzen
true, spoolert 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 Kerngerät spoolt immer QoS 1-Nachrichten, es sei denn, der Spool ist voll.Standard:
false
version-
(Optional) Die Version von MQTT. Sie können entweder
mqtt3odermqtt5angeben.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. Grüngras-Kern
Standard:
100 sessionExpirySeconds-
(Optional) Die Zeitdauer in Sekunden, die Sie bei IoT Core für die Dauer einer Sitzung 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 Wiederverbindungsverhalten. Die Mindestdauer 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. Grüngras-Kern
Standard:
1 maximumReconnectDelaySeconds-
(Optional) Eine Option für das Wiederverbindungsverhalten. Die maximale Zeit 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. Grüngras-Kern
Standard:
120 minimumConnectedTimeBeforeRetryResetSeconds-
(Optional) Eine Option für das Wiederverbindungsverhalten. Die Zeit in Sekunden, für die eine Verbindung aktiv sein muss, bevor die Verzögerung bei Wiederholungsversuchen wieder 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 zum Ausführen der Core-Software verwendet werden sollen. AWS IoT Greengrass Hinweise 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 vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.
iotDataEndpoint-
Der AWS IoT Datenendpunkt für Ihre AWS-Konto.
Wenn Sie die AWS IoT Greengrass Core-Software mit der
--provision trueOption ausführen, ruft die Software Ihre Daten und Anmeldeinformationen von den Endpunkten ab AWS IoT und fügt sie in die Nucleus-Komponente ein. iotCredEndpoint-
Der Endpunkt der AWS IoT Anmeldeinformationen für Ihre AWS-Konto.
Wenn Sie die AWS IoT Greengrass Core-Software mit der
--provision trueOption 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.
(Optional) Der zu verwendende Endpunkt der Greengrass-Datenebene. Stellen Sie ihn
iotdataauf ein, um denselben Endpunkt wie den unter angegebenen IoT-Datenendpunkt zu verwenden.iotDataEndpointIn den folgenden Fällen müssen Sie diese Option auf
iotdatafestlegen:-
Sie verwenden ein Gerätezertifikat, das von einer privaten Zertifizierungsstelle (CA) signiert wurde. Weitere Informationen finden Sie unter Verwenden Sie ein Gerätezertifikat, das von einer privaten Zertifizierungsstelle signiert wurde.
-
Sie stellen Nucleus-Konfigurationsupdates bereit, um die IoT-Konnektivität des Geräts auf eine andere AWS-Konto oder eine andere Region umzustellen. Ohne diese Einstellung bleibt die Datenebene nach dem Konnektivitätswechsel an das ursprüngliche Konto gebunden. Dadurch werden das Herunterladen von Komponenten-Artefakten und die Bedienung der Steuerungsebene unterbrochen. Weitere Informationen finden Sie unter Wechseln Sie ein Greengrass Core-Gerät zu einem anderen AWS-Konto oder Region.
Sie können diese Option während der Bereitstellung oder Installation mithilfe des
--init-configInstaller-Arguments festlegen.Standard:
""(leere Zeichenfolge — verwendet den Greengrass-Serviceendpunkt) -
greengrassDataPlanePort-
Diese Funktion ist in Version 2.0.4 und höher dieser Komponente verfügbar.
(Optional) Der Port, der für Verbindungen auf Datenebene 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 blockierten Port angeben, 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 beispielsweiseggc_useroderggc_user:ggc_groupangeben. Weitere Informationen finden Sie unter Konfigurieren Sie den Benutzer, der die Komponenten ausführt.Wenn Sie das AWS IoT Greengrass Core-Software-Installationsprogramm mit der
--component-default-userOption ausführen, legt die Software diesen Parameter in der Nucleus-Komponente fest.ggc_user:ggc_group 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 sein Passwort müssen in der Credentials Manager-Instanz des LocalSystem Kontos gespeichert werden. 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-userOption ausführen, legt die Software diesen Parameter in der Nucleus-Komponente fest.ggc_user 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 Systemressourcenbeschränkungen, die standardmäßig für generische und nicht containerisierte Lambda-Komponentenprozesse gelten. Sie können die Systemressourcenbeschränkungen 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 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 Kerngerät mit 4 CPU-Kernen können Sie diesen Wert beispielsweise auf festlegen,
2um die Prozesse jeder Komponente auf 50 Prozent der einzelnen CPU-Kerne zu beschränken. Auf einem Gerät mit einem CPU-Kern können Sie diesen Wert auf festlegen,0.25um die CPU-Auslastung der einzelnen Komponenten auf 25 Prozent zu beschränken. Wenn Sie diesen Wert auf eine Zahl setzen, 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 der einzelnen Komponenten auf dem Kerngerät verwenden können.
-
s3EndpointType -
(Optional) Der S3-Endpunkttyp. Dieser Parameter wird nur für die Region USA Ost (Nord-Virginia) (
us-east-1) wirksam. Wenn Sie diesen Parameter von einer anderen Region aus festlegen, wird dies 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 alten Endpunkt. -
DUALSTACK— Die vorsignierte S3-URL verwendet den Dualstack-Endpunkt.
Standard:
GLOBAL -
-
fipsMode -
(Optional) Veranlasst Greengrass, FIPS-Endpunkte zu verwenden. Weitere Informationen zur Aktivierung von FIPS-Endpunkten finden Sie unter FIPS-Endpunkte. FIPS.html
Wählen Sie aus den folgenden Optionen aus:
-
trueWenn der Wert auf „True“ gesetzt ist, verwenden die Endpunkte 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 Protokollnachrichten.
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-Logs-Befehl 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 Kerngerä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
FILEfür angebenoutputType.Standard:
1024 -
totalLogsSizeKB -
(Optional) Die maximale Gesamtgröße der Protokolldateien (in Kilobyte) für jede Komponente, einschließlich des Greengrass-Kernkerns. Die Logdateien des Greengrass Nucleus enthalten auch Logs von Plugin-Komponenten. Komponententypen 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 Protokollmanager Speicherplatzbeschränkung der Log-Manager-Komponente (
diskSpaceLimit), den Sie für den Greengrass Nucleus (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
FILEfüroutputTypeangeben.Standard:
10240 -
outputDirectory -
(Optional) Das Ausgabeverzeichnis für Protokolldateien.
Dieser Parameter gilt nur, wenn Sie
FILEfür angebenoutputType.Standard:
, wo/logs/greengrass/v2ist der AWS IoT Greengrass Stammordner./greengrass/v2
-
-
fleetstatus -
Dieser Parameter ist in Version 2.1.0 und höher dieser Komponente verfügbar.
(Optional) Die Flottenstatus-Konfiguration 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 Systemstatus-Telemetrie für das Kerngerät. Weitere Informationen zu Telemetriemetriken und zum Umgang mit Telemetriedaten 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 die Telemetrie aktivieren oder deaktivieren.
Standard:
true periodicAggregateMetricsIntervalSeconds-
(Optional) Das Intervall (in Sekunden), in dem das Kerngerät Metriken aggregiert.
Wenn Sie diesen Wert unter den unterstützten Mindestwert setzen, verwendet der Nucleus stattdessen den Standardwert.
Minimum:
3600Standard:
3600 periodicPublishMetricsIntervalSeconds-
(Optional) Die Zeitspanne (in Sekunden), zwischen der das Kerngerät Telemetriemetriken an den AWS Cloud veröffentlicht.
Wenn Sie diesen Wert unter den unterstützten Mindestwert setzen, verwendet der Nucleus stattdessen den Standardwert.
Minimum:
86400Standard:
86400
deploymentPollingFrequencySeconds-
(Optional) Der Zeitraum in Sekunden, in dem nach Bereitstellungsbenachrichtigungen gefragt werden soll.
Standard:
15 componentStoreMaxSizeBytes-
(Optional) Die maximale Größe des Komponentenspeichers auf der Festplatte, der Komponentenrezepte und Artefakte umfasst.
Standard:
10000000000(10 GB) -
bootConfigTlogCompactionThresholdBytes -
Dieser Parameter ist in Version 2.18.3 und höher dieser Komponente verfügbar.
(Optional) Der Größenschwellenwert in Byte, bei dem der Greengrass-Nucleus sein Konfigurationstransaktionsprotokoll (
config.tlog) komprimiert, wenn das Kerngerät gestartet wird.Durch die Komprimierung wird Ihre Konfiguration nicht geändert. Es werden nur veraltete Einträge aus dem Protokoll entfernt, wodurch die Startzeit und die Festplattennutzung auf dem Kerngerät reduziert werden.
Um die Komprimierung beim Systemstart zu deaktivieren, setzen Sie diesen Wert auf
0oder einen negativen Wert.Geben Sie den Schwellenwert als Anzahl von Byte an, z. B.
10000000Der Kern akzeptiert auch wissenschaftliche Schreibweisen, wie1e7z. Wenn Sie einen Wert angeben, der keine Zahl ist, wie z. B.20MB, verwendet der Nucleus den Standardwert und zeichnet eine Warnung in seinen Protokollen auf. Ein ungültiger Wert deaktiviert die Komprimierung nicht.Anmerkung
Die Komprimierung verhindert nicht, dass Ihr Gerät gestartet wird. Wenn der Nucleus das Protokoll nicht komprimieren kann, startet das Kerngerät normal mit dem unkomprimierten Protokoll und zeichnet den Fehler in seinen Protokollen auf. Der Nucleus versucht es erneut, wenn das Kerngerät das nächste Mal gestartet wird.
Standard:
10000000(10 MB) -
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 Mindestmenge an Artefakten bereitzustellen, damit eine Komponente ausgeführt werden kann. Weitere Informationen finden Sie im Komponentenrezept unter dem Plattformparameter „Manifest“.
Sie können diesen Parameter auch verwenden, um die Plattformattribute
osund diearchitecturePlattformattribute 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 Kerngerät in einem langsameren Netzwerk läuft, können Sie diese Timeout-Zeiten verlängern, 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 muss, bevor die Verbindungsanforderung das Zeitlimit überschreitet.
Standard:
2000(2 Sekunden) socketTimeoutMs-
(Optional) Die Zeitspanne (in Millisekunden), die auf die Datenübertragung über eine offene Verbindung gewartet werden muss, bevor das Zeitlimit für die Verbindung überschritten wird.
Standard:
30000(30 Sekunden)
-
deploymentConfigurationTimeSource -
Dieser Parameter ist in Version 2.15.0 und höher dieser Komponente verfügbar.
(Optional) Der Zeitstempel, der bei der Verarbeitung einer Bereitstellung verwendet werden soll. Die Standardeinstellung ist die
deploymentCreationTime.Dieses Objekt enthält die folgenden Werte:
deploymentCreationTime-
Der Standardwert von
deploymentConfigurationTimeSource. Das Gerät verwendet den Zeitstempel der Erstellung der Bereitstellung, um Konflikte mit Konfigurationsschlüsseln während der Verarbeitung zu lösen. Wenn dieses Verhalten ausgewählt wird, hat die vom Nucleus gespeicherte lokale Gerätekonfiguration möglicherweise einen größeren Zeitstempel als die eingehende Bereitstellung und lehnt eingehende Konfigurationsänderungen ab, die jetzt als veraltet gelten. deploymentProcessingTime-
Das Gerät verwendet seinen lokalen Zeitstempel, um Konflikte mit Konfigurationsschlüsseln während der Bereitstellung zu lösen. Bei der Verarbeitung aktualisiert das Gerät die Konfigurationen auf der Grundlage des Verarbeitungszeitstempels und nicht des Zeitstempels der Bereitstellungserstellung. Bei diesem Verhalten wird davon ausgegangen, dass die Geräte-Uhr ordnungsgemäß kalibriert ist.
Konfigurieren Sie diese Nucleus-Einstellung in Ihrem ersten Geräte-Image oder Ihrer Erstinstallation und nicht durch eine Bereitstellung, wenn Sie möchten, dass neue Geräte dieses Verhalten bei der ersten Verbindung verwenden. Verwenden Sie für diese Konfiguration die
--init-configOption des Nucleus Classic-Installationsprogramms.Diese Erstkonfiguration ist unerlässlich, da Geräte mehrere Bereitstellungen in beliebiger Reihenfolge verarbeiten. Ohne eine korrekte Erstkonfiguration verarbeitet ein Gerät Bereitstellungen möglicherweise unter Verwendung des
deploymentCreationTimeStandardverhaltens, bevor es die Bereitstellung empfängt, auf die die Nucleus-Konfiguration eingestellt ist.deploymentProcessingTime
Beispiel Beispiel: Aktualisierung der Zusammenführung der Konfiguration
{ "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.
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
oder/greengrass/v2C:\greengrass\v2durch den Pfad zum AWS IoT Greengrass Stammordner.
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
|
Version |
Änderungen |
|---|---|
|
2.18.3 |
|
|
2.18.2 |
|
|
2.18.1 |
|
|
2.18.0 |
|
|
2.17.0 |
|
|
2.16.1 |
|
|
2.16.0 |
|
|
2.15.1 |
|
|
2.15.0 |
|
|
2.14.3 |
Fehlerbehebungen und Verbesserungen
|
|
2.14.2 |
Fehlerbehebungen und Verbesserungen
|
|
2.14.1 |
Fehlerbehebungen und Verbesserungen
|
|
2.14.0 |
WarnungDiese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.
|
|
2.13.0 |
|
|
2.12.6 |
|
|
2.12.5 |
|
|
2.12.4 |
|
|
2.12.3 |
WarnungDiese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. Fehlerbehebungen und Verbesserungen
|
|
2.12.2 |
|
|
2.12.1 |
|
|
2.12.0 |
|
|
2.11.3 |
|
|
2.11.2 |
|
|
2.11.1 |
|
|
2.11.0 |
|
|
2.10.3 |
|
|
2.10.2 |
|
|
2.10.1 |
|
|
2.10.0 |
|
|
2.9.6 |
|
|
2.9.5 |
|
|
2.9.4 |
|
|
2.9.3 |
|
|
2.9.2 |
|
|
2.9.1 |
|
|
2.9.0 |
|
|
2.8.1 |
|
|
2.8.0 |
|
|
2.7.0 |
|
|
2.6.0 |
|
|
2.5.6 |
|
|
2.5.5 |
|
|
2.5.4 |
|
|
2.5.3 |
|
|
2.5.2 |
|
|
2.5.1 |
WarnungDiese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.
|
|
2.5.0 |
|
|
2.4.0 |
|
|
2.3.0 |
|
|
2.2.0 |
|
|
2.1.0 |
|
|
2.0.5 |
|
|
2.0.4 |
|
|
2.0.3 |
Erste Version |