Greengrass CLI - AWS IoT Greengrass

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.

Greengrass CLI

Die Greengrass-CLI-Komponente (aws.greengrass.Cli) bietet eine lokale Befehlszeilenschnittstelle, die Sie auf Kerngeräten verwenden können, um Komponenten lokal zu entwickeln und zu debuggen. Mit der Greengrass-CLI können Sie beispielsweise lokale Bereitstellungen erstellen und Komponenten auf dem Kerngerät neu starten.

Sie können diese Komponente bei der Installation der AWS IoT Greengrass Core-Software installieren. Weitere Informationen finden Sie unter Tutorial: Erste Schritte mit AWS IoT Greengrass V2.

Wichtig

Wir empfehlen, diese Komponente nur in Entwicklungsumgebungen und nicht in Produktionsumgebungen zu verwenden. Diese Komponente bietet Zugriff auf Informationen und Operationen, die Sie in einer Produktionsumgebung normalerweise nicht benötigen. Folgen Sie dem Prinzip der geringsten Rechte, indem Sie diese Komponente nur dort einsetzen, wo Sie sie benötigen.

Führen Sie nach der Installation dieser Komponente den folgenden Befehl aus, um die zugehörige Hilfedokumentation aufzurufen. Bei der Installation dieser Komponente wird dem /greengrass/v2/bin Ordner ein symbolischer Link hinzugefügt. greengrass-cli Sie können die Greengrass-CLI von diesem Pfad aus ausführen oder sie zu Ihrer PATH Umgebungsvariablen hinzufügen, um sie greengrass-cli ohne ihren absoluten Pfad auszuführen.

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

Der folgende Befehl startet beispielsweise eine Komponente mit dem Namen com.example.HelloWorld neu.

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

Weitere Informationen finden Sie unter Greengrass-Befehlszeilenschnittstelle.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 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

Typ

Diese Komponente ist eine Plugin-Komponente (aws.greengrass.plugin). Der Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.

Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter Überwachen von AWS IoT Greengrass Protokollen.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

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

  • Linux

  • Windows

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

  • Sie müssen autorisiert sein, die Greengrass-CLI zu verwenden, um mit der AWS IoT Greengrass Core-Software zu interagieren. Führen Sie einen der folgenden Schritte aus, um die Greengrass-CLI zu verwenden:

    • Verwenden Sie den Systembenutzer, der die AWS IoT Greengrass Core-Software ausführt.

    • Verwenden Sie einen Benutzer mit Root- oder Administratorrechten. Auf Linux-Core-Geräten können Sie diese Option verwenden, um sudo Root-Rechte zu erhalten.

    • Verwenden Sie einen Systembenutzer, der zu einer Gruppe gehört, die Sie bei der Bereitstellung der Komponente in den AuthorizedWindowsGroups Konfigurationsparametern AuthorizedPosixGroups oder angeben. Weitere Informationen finden Sie unter Konfiguration der Greengrass-CLI-Komponente.

  • Die Greengrass-CLI-Komponente wird für die Ausführung in einer VPC unterstützt.

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, stellt sie AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.

2.12.0 – 2.12.4

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.12.0 bis 2.12.4 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.12.0 <2.13.0 Weich
2.11.0 – 2.11.3

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.11.0 bis 2.11.3 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.11.0 <2.12.0 Weich
2.10.0 – 2.10.3

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.10.0 bis 2.10.3 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2,5,0 <2,11,0 Weich
2.9.0 – 2.9.6

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.9.0 bis 2.9.6 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.5.0 <2.10.0 Weich
2.8.0 – 2.8.1

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.8.0 und 2.8.1 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2,5,0 <2,9,0 Weich
2.7.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.7.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2,5,0 <2,8,0 Weich
2.6.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.6.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2,5,0 <2,7,0 Weich
2.5.0 – 2.5.6

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.5.0 bis 2.5.6 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2,5,0 <2,6,0 Weich
2.4.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.1.0 <2.5.0 Weich
2.3.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.1.0 <2.4.0 Weich
2.2.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.1.0 <2.3.0 Weich
2.1.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.1.0 <2.2.0 Weich
2.0.x

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.1.0 Weich
Anmerkung

Die minimale kompatible Version des Greengrass-Nukleus entspricht der Patch-Version der Greengrass-CLI-Komponente.

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.

Konfiguration

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

2.5.x
AuthorizedPosixGroups

(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen-IDs angeben. group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group1, undgroup3)1002, die Greengrass-CLI zu verwenden.

Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Root-Benutzer (sudo) oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.

AuthorizedWindowsGroups

(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen-IDs angeben. group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group1, undgroup3)1002, die Greengrass-CLI zu verwenden.

Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Administrator oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.

Beispiel: Aktualisierung der Zusammenführung von Konfigurationen

Die folgende Beispielkonfiguration legt fest, dass drei POSIX-Systemgruppen (group11002, undgroup3) und zwei Windows-Benutzergruppen (Device OperatorsundQA Engineers) zur Verwendung der Greengrass-CLI autorisiert werden sollen.

{ "AuthorizedPosixGroups": "group1,1002,group3", "AuthorizedWindowsGroups": "Device Operators,QA Engineers" }
2.4.x - 2.0.x
AuthorizedPosixGroups

(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen-IDs angeben. group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group1, undgroup3)1002, die Greengrass-CLI zu verwenden.

Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Root-Benutzer (sudo) oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.

Beispiel: Aktualisierung der Konfigurationszusammenführung

Die folgende Beispielkonfiguration legt fest, dass drei Systemgruppen (group11002, undgroup3) zur Verwendung der Greengrass-CLI autorisiert werden sollen.

{ "AuthorizedPosixGroups": "group1,1002,group3" }

Lokale Protokolldatei

Diese Komponente verwendet dieselbe Protokolldatei wie die Greengrass Nucleus-Komponente.

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.12.4

Die Version wurde für die Version 2.12.4 von Greengrass Nucleus aktualisiert.

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.

Die Version wurde für die Version 2.12.3 von Greengrass Nucleus aktualisiert.

2.12.2

Die Version wurde für die Version 2.12.2 von Greengrass Nucleus aktualisiert.

2.12.1

Die Version wurde für die Version 2.12.1 von Greengrass Nucleus aktualisiert.

2.12.0

Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert.

2.11.3

Die Version wurde für die Version 2.11.3 von Greengrass Nucleus aktualisiert.

2.11.2

Die Version wurde für die Version 2.11.2 von Greengrass Nucleus aktualisiert.

2.11.1

Die Version wurde für die Version 2.11.1 von Greengrass Nucleus aktualisiert.

2.11.0

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

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

  • Verbessert die detaillierte Berichterstattung zum Bereitstellungsstatus.

2.10.3

Die Version wurde für die Version 2.10.3 von Greengrass Nucleus aktualisiert.

2.10.2

Die Version wurde für die Version 2.10.2 von Greengrass Nucleus aktualisiert.

2.10.1

Die Version wurde für die Version 2.10.1 von Greengrass Nucleus aktualisiert.

2.10.0

Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert.

2.9.6

Die Version wurde für die Version 2.9.6 von Greengrass Nucleus aktualisiert.

2.9.5

Die Version wurde für die Version 2.9.5 von Greengrass Nucleus aktualisiert.

2.9.4

Die Version wurde für die Version 2.9.4 von Greengrass Nucleus aktualisiert.

2.9.3

Die Version wurde für die Version 2.9.3 von Greengrass Nucleus aktualisiert.

2.9.2

Die Version wurde für die Version 2.9.2 von Greengrass Nucleus aktualisiert.

2.9.1

Die Version wurde für die Version 2.9.1 von Greengrass Nucleus aktualisiert.

2.9.0

Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert.

2.8.1

Die Version wurde für die Version 2.8.1 von Greengrass Nucleus aktualisiert.

2.8.0

Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert.

2.7.0

Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert.

2.6.0

Neue Features
Fehlerkorrekturen und Verbesserungen
  • Zusätzliche kleinere Korrekturen und Verbesserungen.

2.5.6

Die Version wurde für die Version 2.5.6 von Greengrass Nucleus aktualisiert.

2.5.5

Die Version wurde für die Version 2.5.5 von Greengrass Nucleus aktualisiert.

2.5.4

Die Version wurde für die Version 2.5.4 von Greengrass Nucleus aktualisiert.

2.5.3

Die Version wurde für die Version 2.5.3 von Greengrass Nucleus aktualisiert.

2.5.2

Die Version wurde für die Version 2.5.2 von Greengrass Nucleus aktualisiert.

2.5.1

Die Version wurde für die Version 2.5.1 von Greengrass Nucleus aktualisiert.

2.5.0

Neue Features
  • Fügt Unterstützung für Kerngeräte hinzu, auf denen Windows ausgeführt wird.

  • Fügt den neuen AuthorizedWindowsGroups Konfigurationsparameter hinzu, den Sie angeben können, um Systemgruppen zur Verwendung der Greengrass-CLI auf Windows-Geräten zu autorisieren.

  • Fügt den windowsUser Parameter für lokale Bereitstellungen hinzu. Mit diesem Parameter können Sie den Benutzer angeben, der zum Ausführen von Komponenten auf einem Windows-Core-Gerät verwendet werden soll.

2.4.0

Neue Features

2.3.0

Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert.

2.2.0

Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert.

2.1.0

Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert.

2.0.5

Die Version wurde für die Version 2.0.5 von Greengrass Nucleus aktualisiert.

2.0.4

Die Version wurde für die Version 2.0.4 von Greengrass Nucleus aktualisiert.

2.0.3

Erste Version