Installer-Argumente - 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.

Installer-Argumente

Die -AWS IoT GreengrassCore-Software enthält ein Installationsprogramm, das die Software einrichtet und die erforderlichen AWS Ressourcen für die Ausführung des Greengrass-Core-Geräts bereitstellt. Das Installationsprogramm enthält die folgenden Argumente, die Sie zur Konfiguration der Installation angeben können:

-h, --help

(Optional) Zeigen Sie die Hilfeinformationen des Installationsprogramms an.

--version

(Optional) Zeigen Sie die Version der -AWS IoT GreengrassCore-Software an.

-Droot

(Optional) Der Pfad zum Ordner, der als Stamm für die AWS IoT Greengrass Core-Software verwendet werden soll.

Anmerkung

Dieses Argument legt eine JVM-Eigenschaft fest, daher müssen Sie sie zuvor angeben, -jar wenn Sie das Installationsprogramm ausführen. Geben Sie beispielsweise java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar an.

Standard:

  • Linux: ~/.greengrass

  • Windows: %USERPROFILE%/.greengrass

-ar, --aws-region

Die AWS-Region, die die AWS IoT Greengrass -Core-Software zum Abrufen oder Erstellen ihrer erforderlichen AWS Ressourcen verwendet.

-p, --provision

(Optional) Sie können dieses Gerät als -AWS IoTObjekt registrieren und die AWS Ressourcen bereitstellen, die das Core-Gerät benötigt. Wenn Sie angebentrue, stellt die -AWS IoT GreengrassCore-Software ein -AWS IoTObjekt, (optional) eine -AWS IoTObjektgruppe, eine IAM-Rolle und einen -AWS IoTRollenalias bereit.

Standard: false

-tn, --thing-name

(Optional) Der Name des AWS IoT Objekts, das Sie als dieses Core-Gerät registrieren. Wenn das Objekt mit dem Namen in Ihrem nicht vorhanden istAWS-Konto, erstellt die AWS IoT Greengrass Core-Software es.

Anmerkung

Der Objektname darf keine Doppelpunktzeichen (:) enthalten.

Sie müssen angeben--provision true, um dieses Argument anzuwenden.

Standard: GreengrassV2IotThing_ plus eine zufällige UUID.

-tgn, --thing-group-name

(Optional) Der Name der AWS IoT Objektgruppe, zu der Sie das AWS IoT Objekt dieses Core-Geräts hinzufügen. Wenn eine Bereitstellung auf diese Objektgruppe abzielt, erhält dieses Core-Gerät diese Bereitstellung, wenn es eine Verbindung zu herstelltAWS IoT Greengrass. Wenn die Objektgruppe mit diesem Namen in Ihrem nicht vorhanden istAWS-Konto, erstellt die AWS IoT Greengrass Core-Software sie.

Anmerkung

Der Objektgruppenname darf keine Doppelpunktzeichen (:) enthalten.

Sie müssen angeben--provision true, um dieses Argument anzuwenden.

-tpn, --thing-policy-name

Diese Funktion ist für v2.4.0 und höher der Greengrass-Kernkomponente verfügbar.

(Optional) Der Name der AWS IoT Richtlinie, die an das AWS IoT Objektzertifikat dieses Core-Geräts angehängt werden soll. Wenn die AWS IoT Richtlinie mit diesem Namen in Ihrem nicht vorhanden istAWS-Konto, erstellt die AWS IoT Greengrass Core-Software sie.

Die AWS IoT Greengrass -Core-Software erstellt standardmäßig eine zulässige AWS IoT Richtlinie. Sie können diese Richtlinie einschränken oder eine benutzerdefinierte Richtlinie erstellen, in der Sie die Berechtigungen für Ihren Anwendungsfall einschränken. Weitere Informationen finden Sie unter Minimale AWS IoT Richtlinie für -AWS IoT Greengrass V2Core-Geräte.

Sie müssen angeben--provision true, um dieses Argument anzuwenden.

Standard: GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(Optional) Der Name der IAM-Rolle, die zum Abrufen von AWS Anmeldeinformationen verwendet werden soll, mit denen das Core-Gerät mit -AWSServices interagieren kann. Wenn die Rolle mit diesem Namen in Ihrem nicht vorhanden istAWS-Konto, erstellt die AWS IoT Greengrass Core-Software sie mit der GreengrassV2TokenExchangeRoleAccess Richtlinie . Diese Rolle hat keinen Zugriff auf Ihre S3-Buckets, in denen Sie Komponentenartefakte hosten. Daher müssen Sie den S3-Buckets und -Objekten Ihrer Artefakte Berechtigungen hinzufügen, wenn Sie eine Komponente erstellen. Weitere Informationen finden Sie unter Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS.

Sie müssen angeben--provision true, um dieses Argument anzuwenden.

Standard: GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(Optional) Der Name des AWS IoT Rollenalias, der auf die IAM-Rolle verweist, die AWS Anmeldeinformationen für dieses Core-Gerät bereitstellt. Wenn der Rollenalias mit diesem Namen in Ihrem nicht vorhanden istAWS-Konto, erstellt die -AWS IoT GreengrassCore-Software ihn und verweist ihn auf die von Ihnen angegebene IAM-Rolle.

Sie müssen angeben--provision true, um dieses Argument anzuwenden.

Standard: GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(Optional) Sie können die AWS IoT Greengrass -Core-Software als Systemservice einrichten, der beim Start dieses Geräts ausgeführt wird. Der Systemservicename lautet greengrass. Weitere Informationen finden Sie unter Den Greengrass Nucleus als Systemdienst konfigurieren.

Unter Linux-Betriebssystemen erfordert dieses Argument, dass das systemd init-System auf dem Gerät verfügbar ist.

Wichtig

Auf Windows-Core-Geräten müssen Sie die AWS IoT Greengrass Core-Software als Systemservice einrichten.

Standard: false

-u, --component-default-user

Der Name oder die ID des Benutzers, den die AWS IoT Greengrass Core-Software zum Ausführen von Komponenten verwendet. Sie können beispielsweise ggc_user angeben. Dieser Wert ist erforderlich, wenn Sie das Installationsprogramm unter Windows-Betriebssystemen ausführen.

Unter Linux-Betriebssystemen können Sie optional auch die Gruppe angeben. Geben Sie den Benutzer und die Gruppe durch einen Doppelpunkt getrennt an. Beispiel: ggc_user:ggc_group

Für Linux-Betriebssysteme gelten die folgenden zusätzlichen Überlegungen:

  • Wenn Sie als Stamm ausführen, ist der Standardkomponentenbenutzer der Benutzer, der in der Konfigurationsdatei definiert ist. Wenn die Konfigurationsdatei keinen Benutzer definiert, ist dies standardmäßig ggc_user:ggc_group. Wenn ggc_user oder ggc_group nicht vorhanden sind, erstellt die Software sie.

  • Wenn Sie als Nicht-Root-Benutzer ausführen, verwendet die AWS IoT Greengrass -Core-Software diesen Benutzer, um Komponenten auszuführen.

  • Wenn Sie keine Gruppe angeben, verwendet die AWS IoT Greengrass Core-Software die primäre Gruppe des Systembenutzers.

Weitere Informationen finden Sie unter Konfigurieren Sie den Benutzer, der die Komponenten ausführt.

-d, --deploy-dev-tools

(Optional) Sie können die Greengrass-CLI-Komponente herunterladen und auf diesem Core-Gerät bereitstellen. Sie können dieses Tool verwenden, um Komponenten auf diesem Core-Gerät zu entwickeln und zu debuggen.

Wichtig

Wir empfehlen, diese Komponente nur in Entwicklungsumgebungen und nicht in Produktionsumgebungen zu verwenden. Diese Komponente bietet Zugriff auf Informationen und Vorgänge, die Sie normalerweise in einer Produktionsumgebung nicht benötigen. Folgen Sie dem Prinzip der geringsten Berechtigung, indem Sie diese Komponente nur auf Core-Geräten bereitstellen, auf denen Sie sie benötigen.

Sie müssen angeben--provision true, um dieses Argument anzuwenden.

Standard: false

-init, --init-config

(Optional) Der Pfad zur Konfigurationsdatei, die zur Installation der AWS IoT Greengrass Core-Software verwendet werden soll. Sie können diese Option verwenden, um beispielsweise neue Core-Geräte mit einer bestimmten Kernkonfiguration einzurichten.

Wichtig

Die von Ihnen angegebene Konfigurationsdatei wird mit der vorhandenen Konfigurationsdatei auf dem Core-Gerät zusammengeführt. Dazu gehören die Komponenten und Komponentenkonfigurationen auf dem Core-Gerät. Wir empfehlen, dass die Konfigurationsdatei nur die Konfigurationen auflistet, die Sie ändern möchten.

-tp, --trusted-plugin

(Optional) Der Pfad zu einer JAR-Datei, die als vertrauenswürdiges Plugin geladen werden soll. Verwenden Sie diese Option, um Bereitstellungs-Plugin-JAR-Dateien bereitzustellen, z. B. um mit Flottenbereitstellung oder benutzerdefinierte Bereitstellung zu installieren, oder um mit dem privaten Schlüssel und dem Zertifikat in einem Hardware-Sicherheitsmodul zu installieren.

-s, --start

(Optional) Sie können die AWS IoT Greengrass -Core-Software starten, nachdem sie installiert und optional Ressourcen bereitgestellt hat.

Standard: true