AWS IoT GreengrassBefehlszeilenschnittstelle des Development Kits - AWS IoT Greengrass
VoraussetzungenÄ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.

AWS IoT GreengrassBefehlszeilenschnittstelle des Development Kits

Die Befehlszeilenschnittstelle (GDK CLI) desAWS IoT Greengrass Development Kit bietet Funktionen, mit denen Sie benutzerdefinierte Greengrass-Komponenten entwickeln können. Sie können die GDK-CLI verwenden, um benutzerdefinierte Komponenten zu erstellen, zu erstellen und zu veröffentlichen. Wenn Sie ein Komponenten-Repository mit der GDK-CLI erstellen, können Sie mit einer Vorlage oder einer Community-Komponente aus dem Greengrass-Softwarekatalog beginnen. Dann können Sie ein Build-System wählen, das Dateien als ZIP-Archive verpackt, ein Maven- oder Gradle-Build-Skript verwendet oder einen benutzerdefinierten Build-Befehl ausführt. Nachdem Sie eine Komponente erstellt haben, können Sie die GDK-CLI verwenden, um sie imAWS IoT Greengrass Service zu veröffentlichen, sodass Sie dieAWS IoT Greengrass Konsole oder API verwenden können, um die Komponente auf Ihren Greengrass-Core-Geräten bereitzustellen.

Wenn Sie Greengrass-Komponenten ohne die GDK-CLI entwickeln, müssen Sie die Versions- und Artefakt-URIs in der Komponentenrezeptdatei jedes Mal aktualisieren, wenn Sie eine neue Version der Komponente erstellen. Wenn Sie die GDK-CLI verwenden, kann sie die Version und die Artefakt-URIs automatisch für Sie aktualisieren, wenn Sie eine neue Version der Komponente veröffentlichen.

Die GDK-CLI ist Open Source und verfügbar auf GitHub. Sie können die GDK-CLI anpassen und erweitern, um Ihre Anforderungen an die Komponentenentwicklung zu erfüllen. Wir laden Sie ein, Issues und Pull-Requests im GitHub Repository zu öffnen. Die GDK-CLI-Quelle finden Sie unter dem folgenden Link: https://github.com/aws-greengrass/aws-greengrass-gdk-cli.

Voraussetzungen

Um die Greengrass Development Kit CLI zu installieren und zu verwenden, benötigen Sie Folgendes:

  • Eine AWS-Konto Falls Sie noch keines haben, beachten Sie die Informationen unter Richten Sie eine einAWS-Konto.

  • Ein Windows-, macOS- oder UNIX-ähnlicher Entwicklungscomputer mit einer Internetverbindung.

  • In GDK CLI Version 1.1.0 oder höher ist Python-3.6 oder höher auf Ihrem Entwicklungscomputer installiert.

    Für GDK CLI Version 1.0.0 ist Python 3.8 oder höher auf Ihrem Entwicklungscomputer installiert.

  • Git ist auf Ihrem Entwicklungscomputer installiert.

  • AWS Command Line Interface(AWS CLI) installiert und mit Anmeldeinformationen auf Ihrem Entwicklungscomputer konfiguriert. Weitere Informationen finden Sie unter Installation, Aktualisierung und Deinstallation vonAWS CLI und Konfiguration vonAWS CLI imAWS Command Line Interface Benutzerhandbuch.

    Anmerkung

    Wenn Sie einen Raspberry Pi oder ein anderes 32-Bit-ARM-Gerät verwenden, installieren SieAWS CLI V1. AWS CLI V2 ist für 32-Bit-ARM-Geräte nicht verfügbar. Weitere Informationen finden Sie unter Installieren, Aktualisieren und Deinstallieren vonAWS CLI Version 1

  • Zum Verwenden der GDK-CLI zum Veröffentlichen von Komponenten für denAWS IoT Greengrass Service benötigen Sie folgende Berechtigungen:

    • s3:CreateBucket

    • s3:GetBucketLocation

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • Um mit der GDK-CLI eine Komponente zu erstellen, deren Artefakte in einem S3-Bucket und nicht im lokalen Dateisystem existieren, benötigen Sie die folgenden Berechtigungen:

    • s3:ListBucket

    Diese Funktion ist für GDK CLI v1.1.0 und höher verfügbar.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der GDK CLI des GDK. Weitere Informationen finden Sie auf der Seite GDK CLI Releases unter GitHub.

Version

Änderungen
1.2.3
Fehlerbehebungen

  • Behebt ein Problem, durch das die Fehlerbehebungen aufgrund einer fehlerhaften Fehlerbehebungen.

  • Behebt ein Problem, bei dem Listenstrukturen im Komponentenrezept entfernt wurden.
1.2.2
Fehlerbehebungen

  • Bei Rezeptschlüsseln wird nicht mehr zwischen Groß- und Kleinschreibung unterschieden.

  • Fügt eine Prüfung hinzu, um festzustellen, ob ein Bucket in einem Bucket vorhanden istAWS-Region und auf den der Benutzer zugreifen kann, bevor ein neuer Bucket erstellt wird. Erfordert, dass der Benutzer über dieGetBucketLocation Erlaubnis verfügt.

  • Behebt ein Problem mit demexcludes Schlüsselwort in der GDK-CLI-Konfigurationsdatei.
1.2.1
Fehlerbehebungen

  • Akzeptiert den Konfigurationseintrag Kanada (Centralca-central-1) ()AWS-Region in der Region in dergdk-config.json Datei.

  • Behebt Probleme mit dem--region GDK-CLI-Argument für denpublish Befehl.
1.2.0
Neue Funktionen

  • Fügt denoptions Eintrag zurbuild Konfiguration in der GDK-CLI-Konfigurationsdatei hinzu. Unterstütztexcludes unteroptions, um bestimmte Dateien aus dem Zip-Artefakt auszuschließen, wenn daszip Build-System verwendet wird.

  • Fügt dasgradlew Build-System hinzu, um Gradle Wrapper zum Erstellen von Komponenten zu verwenden.

  • Fügt Unterstützung für Kotlin DSL-Build-Dateien für diegradle Build-Option hinzu.

  • Fügtoptions derpublish Konfiguration in der GDK-CLI-Konfigurationsdatei einen Eintrag hinzu. Unterstützt dasfile_upload_argsoptions Unterverzeichnis, um zusätzliche Argumente beim Hochladen von Dateien auf Amazon S3 bereitzustellen.

Fehlerbehebungen

  • Behebt ein Problem, bei dem Gradle-Builds vor dem Ausführen eines Build-Befehls nicht bereinigt wurden.

  • Behebt ein Problem, bei dem der Build nicht beendet wurde, wenn der Build-Befehl fehlschlägt.

  • Verbessert das Ausgabeformat desgdk component list Befehls.

1.1.0
Neue Funktionen

  • Fügt Unterstützung für das Gradle-Build-System hinzu.

  • Fügt Unterstützung für das Maven-Build-System auf Windows-Geräten hinzu.

  • Fügt das--bucket Argument dem Befehl zum Veröffentlichen der Komponente hinzu. Sie können dieses Argument verwenden, um den genauen Bucket anzugeben, in den die GDK-CLI Komponentenartefakte hochlädt.

  • Fügt das--name Argument dem Init-Befehl der Komponente hinzu. Mit dieser Option können Sie den Ordner angeben, in dem die GDK-CLI die Komponente initialisiert.

  • Fügt Unterstützung für Komponentenartefakte hinzu, die in einem S3-Bucket, aber nicht im lokalen Komponenten-Build-Ordner vorhanden sind. Mit dieser Funktion können Sie die Bandbreitenkosten für Artefakte großer Komponenten, wie z. B. Modelle für maschinelles Lernen, reduzieren.

Fehlerbehebungen

  • Aktualisiert den Befehl zum Veröffentlichen der Komponente, um zu überprüfen, ob die Komponente erstellt wurde, bevor die Komponente veröffentlicht wird. Wenn die Komponente nicht erstellt wurde, erstellt dieser Befehl die Komponente jetzt für Sie.

  • Behebt ein Problem, bei dem das ZIP-Build-System auf Windows-Geräten nicht erstellt werden kann, wenn der ZIP-Dateiname Großbuchstaben enthält.

  • Verbessert das Format für Protokollnachrichten und ändert die StandardprotokollebeneINFO auf Geräte, auf denen Python-Versionen vor 3.8 ausgeführt werden.

  • Ändert die Python-Mindestanforderung an Python 3.6.

1.0.0

Erste Version