View a markdown version of this page

Greengrass CLI - AWS IoT Greengrass
VersionenTypBetriebssystemVoraussetzungenAbhängigkeitenKonfigurationLokale 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.

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 installieren, wenn Sie die 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.

Nachdem Sie diese Komponente installiert haben, führen Sie den folgenden Befehl aus, um die zugehörige Hilfedokumentation anzuzeigen. Bei der Installation dieser Komponente wird dem /greengrass/v2/bin Ordner ein symbolischer Link hinzugefügtgreengrass-cli. Sie können die Greengrass-CLI von diesem Pfad aus ausführen oder sie 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.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

Typ

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

Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Nucleus. Weitere Informationen finden Sie unter AWS IoT Greengrass Protokolle überwachen.

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 es verwenden, um sudo Root-Rechte zu erhalten.

    • Verwenden Sie einen Systembenutzer, der zu einer Gruppe gehört, die Sie in den AuthorizedWindowsGroups Konfigurationsparametern AuthorizedPosixGroups oder angeben, wenn Sie die Komponente bereitstellen. 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, werden AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereitgestellt. Das bedeutet, dass Sie die Anforderungen für die Komponente und alle ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitzustellen. 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 die Abhängigkeiten für jede Version der Komponente auch in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.

2.16.0

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =2,1,0 <2,17,0 Weich
2.15.1

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =2,12,0 <2,16,0 Weich
2.15.0

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =2,12,0 <2,16,0 Weich
2.14.0 – 2.14.3

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =2,12,0 <2,15,0 Weich
2.13.0

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =2,12,0 <2,14,0 Weich
2.12.0 – 2.12.6

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =2,1,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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =2,5,0 <2,1,0 Weich
2.8.0 – 2.8.1

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =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 Typ der Abhängigkeit
Kern von Greengrass > =2,0,0 <2,10 Weich
Anmerkung

Die kompatible Mindestversion des Greengrass Nucleus entspricht der Patch-Version der Greengrass-CLI-Komponente.

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Komponentenrezeptreferenz.

Konfiguration

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

2.5.x - 2.14.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 Core-Software zu verwenden. AWS IoT Greengrass Sie können Gruppennamen oder Gruppen-IDs angeben. group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group11002, undgroup3) zur Verwendung der Greengrass-CLI.

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

AuthorizedWindowsGroups

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

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

Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen

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 kommagetrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass CLI für die Interaktion mit der Core-Software zu verwenden. AWS IoT Greengrass Sie können Gruppennamen oder Gruppen-IDs angeben. group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group11002, undgroup3) zur Verwendung der Greengrass-CLI.

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

Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen

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

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.18.3.

2.18.2

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.18.2.

2.18.1

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.18.1.

2.18.0

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.18.0.

2.17.0

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.17.0.

2.16.1

Die Version wurde für die Greengrass Nucleus-Version 2.16.1 aktualisiert.

2.16.0

Die Version wurde für die Greengrass Nucleus-Version 2.16.0 aktualisiert.

2.15.1

Die Version wurde für die Greengrass Nucleus-Version 2.15.1 aktualisiert.

2.15.0
Fehlerbehebungen und Verbesserungen

  • Fügt einen Fix hinzu, sodass die Komponente nicht neu installiert, sondern trotzdem neu gestartet wird, wenn sich die Authentifizierungskonfiguration ändert.

  • Allgemeine Fehlerbehebungen und Verbesserungen.

2.14.3

Die Version wurde für die Greengrass Nucleus-Version 2.14.3 aktualisiert.

2.14.2

Die Version wurde für die Veröffentlichung von Greengrass Nucleus Version 2.14.2 aktualisiert.

2.14.1

Die Version wurde für die Greengrass Nucleus-Version 2.14.1 aktualisiert.

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.

Fehlerbehebungen und Verbesserungen

  • Überprüfen Sie den Zielparameter für die Bereitstellung im CLI-Befehl.

2.13.0

Die Version wurde für die Greengrass Nucleus-Version 2.13.0 aktualisiert.

2.12.6

Die Version wurde für die Greengrass Nucleus-Version 2.12.6 aktualisiert.

2.12.5

Die Version wurde für die Greengrass Nucleus-Version 2.12.5 aktualisiert.

2.12.4

Die Version wurde für die Greengrass Nucleus-Version 2.12.4 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 Greengrass Nucleus-Version 2.12.3 aktualisiert.

2.12.2

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

2.12.1

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

2.12.0

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

2.11.3

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

2.11.2

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

2.11.1

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

2.11.0
Neue Features

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

  • Ermöglicht es Ihnen, eine Richtlinie zur Fehlerbehandlung für eine lokale Bereitstellung zu konfigurieren.

  • Verbessert die detaillierte Berichterstattung über den Bereitstellungsstatus.

2.10.3

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

2.10.2

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

2.10.1

Version für die Veröffentlichung von Greengrass Nucleus Version 2.10.1 aktualisiert.

2.10.0

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

2.9.6

Version für die Veröffentlichung von Greengrass Nucleus Version 2.9.6 aktualisiert.

2.9.5

Version für die Veröffentlichung von Greengrass Nucleus Version 2.9.5 aktualisiert.

2.9.4

Version für die Veröffentlichung von Greengrass Nucleus Version 2.9.4 aktualisiert.

2.9.3

Version für die Veröffentlichung von Greengrass Nucleus Version 2.9.3 aktualisiert.

2.9.2

Version für die Veröffentlichung von Greengrass Nucleus Version 2.9.2 aktualisiert.

2.9.1

Version für die Veröffentlichung von Greengrass Nucleus Version 2.9.1 aktualisiert.

2.9.0

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

2.8.1

Version für die Veröffentlichung von Greengrass Nucleus Version 2.8.1 aktualisiert.

2.8.0

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

2.7.0

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

2.6.0
Neue Features

  • Integriert die Unterstützung für benutzerdefinierte Komponenten zum Aufrufen von IPC-Vorgängen (Interprocess Communication), die von der Greengrass CLI verwendet werden. Sie können diese IPC-Operationen verwenden, um lokale Bereitstellungen zu verwalten, Komponentendetails anzuzeigen und ein Passwort zu generieren, mit dem Sie sich bei der lokalen Debug-Konsole anmelden können. Lokale Debug-Konsole Weitere Informationen finden Sie unter IPC: Lokale Bereitstellungen und Komponenten verwalten.

Fehlerbehebungen und Verbesserungen

  • Weitere kleinere Korrekturen und Verbesserungen.

2.5.6

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

2.5.5

Version für die Veröffentlichung von Greengrass Nucleus Version 2.5.5 aktualisiert.

2.5.4

Version für die Veröffentlichung von Greengrass Nucleus Version 2.5.4 aktualisiert.

2.5.3

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

2.5.2

Version für Greengrass Nucleus Version 2.5.2 aktualisiert.

2.5.1

Die Version wurde für die Greengrass Nucleus-Version 2.5.1 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 Greengrass Nucleus-Version 2.3.0 aktualisiert.

2.2.0

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

2.1.0

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

2.0.5

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

2.0.4

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

2.0.3

Erste Version