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 das installieren AWS IoT Greengrass Kernsoftware. Weitere Informationen finden Sie unter Tutorial: Erste Schritte mit AWS IoT Greengrass V2.

Wichtig

Wir empfehlen, dass Sie diese Komponente nur in Entwicklungsumgebungen und nicht in Produktionsumgebungen 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 aufzurufen. Bei der Installation dieser Komponente wird ein symbolischer Link zu hinzugefügt greengrass-cli in der /greengrass/v2/bin Ordner. Sie können die Greengrass CLI von diesem Pfad aus ausführen oder sie zu Ihrem hinzufügen PATH auszuführende Umgebungsvariable greengrass-cli ohne ihren absoluten Pfad.

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

Mit dem folgenden Befehl wird eine Komponente mit dem Namen neu gestartet com.example.HelloWorld, zum Beispiel.

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). Das Kern von Greengrass 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 dem zu interagieren AWS IoT Greengrass Kernsoftware. Gehen Sie wie folgt vor, um die Greengrass-CLI zu verwenden:

    • Verwenden Sie den Systembenutzer, der das ausführt AWS IoT Greengrass Kernsoftware.

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

    • Verwenden Sie einen Systembenutzer, der zu einer Gruppe gehört, die Sie in der AuthorizedPosixGroups oder AuthorizedWindowsGroups Konfigurationsparameter, 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, AWS IoT Greengrass stellt auch kompatible Versionen seiner 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 bereitzustellen. In diesem Abschnitt werden die Abhängigkeiten für die aufgeführt veröffentlichte Versionen dieser Komponente und der semantischen Versionsbeschränkungen, 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. Suchen Sie auf der Seite mit den Komponentendetails nach Abhängigkeiten Liste.

2.18.0 - 2.18.4

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

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

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

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Kern von Greengrass > =2,12,0 <2,18,0 Weich
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 Referenz zum Komponenten-Rezept.

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 zu verwenden, um mit dem zu interagieren AWS IoT Greengrass Kernsoftware. Sie können Gruppennamen oder Gruppen-IDs angeben. Zum Beispiel group1,1002,group3 autorisiert drei Systemgruppen (group1, 1002, und group3), um die Greengrass CLI zu verwenden.

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

AuthorizedWindowsGroups

(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass CLI zu verwenden, um mit dem zu interagieren AWS IoT Greengrass Kernsoftware. Sie können Gruppennamen oder Gruppen-IDs angeben. Zum Beispiel group1,1002,group3 autorisiert drei Systemgruppen (group1, 1002, und group3), um 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 Kernsoftware.

Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen

Die folgende Beispielkonfiguration spezifiziert die Autorisierung von drei POSIX-Systemgruppen (group1, 1002, und group3) und zwei Windows-Benutzergruppen (Device Operators und QA Engineers), um die Greengrass CLI zu verwenden.

{
  "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 zu verwenden, um mit dem zu interagieren AWS IoT Greengrass Kernsoftware. Sie können Gruppennamen oder Gruppen-IDs angeben. Zum Beispiel group1,1002,group3 autorisiert drei Systemgruppen (group1, 1002, und group3), um die Greengrass CLI zu verwenden.

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

Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen

Die folgende Beispielkonfiguration legt fest, dass drei Systemgruppen autorisiert werden sollen (group1, 1002, und group3), um die Greengrass CLI zu verwenden.

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

Lokale Protokolldatei

Diese Komponente verwendet dieselbe Protokolldatei wie die Kern von Greengrass 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 /greengrass/v2 oder C:\greengrass\v2 mit dem 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.4

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

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 Veröffentlichung von 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 Veröffentlichung von 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 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

Version für Greengrass Nucleus Version 2.5.3 aktualisiert.

2.5.2

Version für Greengrass Nucleus Version 2.5.2 aktualisiert.

2.5.1

Version für 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 das Neue hinzu AuthorizedWindowsGroups Konfigurationsparameter, den Sie angeben können, um Systemgruppen zur Verwendung der Greengrass-CLI auf Windows-Geräten zu autorisieren.

  • Fügt das hinzu windowsUser Parameter für lokale Bereitstellungen. 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

Version für die Veröffentlichung von 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

 Version für Greengrass Nucleus Version 2.0.5 aktualisiert.

2.0.4

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

2.0.3

Erste Version