Installieren der AWS IoT Greengrass Core-Software (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.

Installieren der AWS IoT Greengrass Core-Software (CLI)

So installieren und konfigurieren Sie die AWS IoT Greengrass -Core-Software

  1. Führen Sie auf Ihrem Greengrass-Core-Gerät den folgenden Befehl aus, um zum Stammverzeichnis zu wechseln.

    Linux or Unix
    cd ~
    Windows Command Prompt (CMD)
    cd %USERPROFILE%
    PowerShell
    cd ~

  2. Laden Sie die AWS IoT Greengrass Core-Software auf Ihr Core-Gerät in eine Datei mit dem Namen heruntergreengrass-nucleus-latest.zip.

    Linux or Unix
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
    Windows Command Prompt (CMD)
    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
    PowerShell
    iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

    Mit dem Download dieser Software stimmen Sie der Greengrass Core-Software-Lizenzvereinbarung zu.

  3. Entpacken Sie die AWS IoT Greengrass Core-Software in einen Ordner auf Ihrem Gerät. Ersetzen Sie durch GreengrassInstaller den Ordner, den Sie verwenden möchten.

    Linux or Unix
    unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip
    Windows Command Prompt (CMD)
    mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip
    PowerShell
    Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
rm greengrass-nucleus-latest.zip

  4. Führen Sie den folgenden Befehl aus, um das AWS IoT Greengrass Core-Softwareinstallationsprogramm zu starten. Der Befehl hat folgende Auswirkungen:

    • Erstellen Sie die AWS Ressourcen, die das Core-Gerät für den Betrieb benötigt.

    • Richten Sie die AWS IoT Greengrass Core-Software als Systemservice ein, der beim Booten ausgeführt wird. Auf Linux-Geräten erfordert dies das Systemd-Init-System.

      Wichtig

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

    • Stellen Sie die AWS IoT Greengrass CLI-Komponente bereit. Dabei handelt es sich um ein Befehlszeilen-Tool, mit dem Sie benutzerdefinierte Greengrass-Komponenten auf dem Core-Gerät entwickeln können.

    • Geben Sie an, um den ggc_user Systembenutzer zum Ausführen von Softwarekomponenten auf dem Core-Gerät zu verwenden. Auf Linux-Geräten gibt dieser Befehl auch an, die ggc_group Systemgruppe zu verwenden, und das Installationsprogramm erstellt den Systembenutzer und die Systemgruppe für Sie.

    Ersetzen Sie die Argumentwerte in Ihrem Befehl wie folgt.

    1. /greengrass/v2 oder C:\greengrass\v2: Der Pfad zum Stammordner, der zur Installation der AWS IoT Greengrass Core-Software verwendet werden soll.

    2. GreengrassInstaller. Der Pfad zu dem Ordner, in dem Sie das AWS IoT Greengrass Core-Softwareinstallationsprogramm entpackt haben.

    3. Region. Die , AWS-Region in der Ressourcen gefunden oder erstellt werden sollen.

    4. MyGreengrassCore. Der Name des AWS IoT Objekts für Ihr Greengrass-Core-Gerät. Wenn das Objekt nicht vorhanden ist, erstellt das Installationsprogramm es. Das Installationsprogramm lädt die Zertifikate herunter, um sich als das AWS IoT Objekt zu authentifizieren. Weitere Informationen finden Sie unter Geräteauthentifizierung und -autorisierung für AWS IoT Greengrass.

      Anmerkung

      Der Objektname darf keine Doppelpunktzeichen (:) enthalten.

    5. MyGreengrassCoreGroup. Der Name der AWS IoT Objektgruppe für Ihr Greengrass-Kerngerät. Wenn die Objektgruppe nicht vorhanden ist, erstellt das Installationsprogramm sie und fügt ihr das Objekt hinzu. Wenn die Objektgruppe vorhanden ist und über eine aktive Bereitstellung verfügt, lädt das Core-Gerät die von der Bereitstellung angegebene Software herunter und führt sie aus.

      Anmerkung

      Der Objektgruppenname darf keine Doppelpunktzeichen (:) enthalten.

    6. GreengrassV2IoTThingPolicy . Der Name der AWS IoT Richtlinie, die den Greengrass-Core-Geräten die Kommunikation mit AWS IoT und ermöglichtAWS IoT Greengrass. Wenn die AWS IoT Richtlinie nicht vorhanden ist, erstellt das Installationsprogramm eine permissive AWS IoT Richtlinie mit diesem Namen. Sie können die Berechtigungen dieser Richtlinie für Ihren Anwendungsfall einschränken. Weitere Informationen finden Sie unter Minimale AWS IoT Richtlinie für -AWS IoT Greengrass V2Core-Geräte.

    7. GreengrassV2TokenExchangeRole. Der Name der IAM-Rolle, die es dem Greengrass-Kerngerät ermöglicht, temporäre AWS Anmeldeinformationen zu erhalten. Wenn die Rolle nicht vorhanden ist, erstellt das Installationsprogramm sie und erstellt und fügt eine Richtlinie mit dem Namen anGreengrassV2TokenExchangeRoleAccess. Weitere Informationen finden Sie unter Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS.

    8. GreengrassCoreTokenExchangeRoleAlias. Der Alias für die IAM-Rolle, die es dem Greengrass-Core-Gerät ermöglicht, später temporäre Anmeldeinformationen zu erhalten. Wenn der Rollenalias nicht vorhanden ist, erstellt das Installationsprogramm ihn und verweist ihn auf die von Ihnen angegebene IAM-Rolle. Weitere Informationen finden Sie unter Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS.

    Linux or Unix
    sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
  -jar ./GreengrassInstaller/lib/Greengrass.jar \
  --aws-region region \
  --thing-name MyGreengrassCore \
  --thing-group-name MyGreengrassCoreGroup \
  --thing-policy-name GreengrassV2IoTThingPolicy \
  --tes-role-name GreengrassV2TokenExchangeRole \
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
  --component-default-user ggc_user:ggc_group \
  --provision true \
  --setup-system-service true \
  --deploy-dev-tools true
    Windows Command Prompt (CMD)
    java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
  -jar ./GreengrassInstaller/lib/Greengrass.jar ^
  --aws-region region ^
  --thing-name MyGreengrassCore ^
  --thing-group-name MyGreengrassCoreGroup ^
  --thing-policy-name GreengrassV2IoTThingPolicy ^
  --tes-role-name GreengrassV2TokenExchangeRole ^
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
  --component-default-user ggc_user ^
  --provision true ^
  --setup-system-service true ^
  --deploy-dev-tools true
    PowerShell
    java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
  -jar ./GreengrassInstaller/lib/Greengrass.jar `
  --aws-region region `
  --thing-name MyGreengrassCore `
  --thing-group-name MyGreengrassCoreGroup `
  --thing-policy-name GreengrassV2IoTThingPolicy `
  --tes-role-name GreengrassV2TokenExchangeRole `
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
  --component-default-user ggc_user `
  --provision true `
  --setup-system-service true `
  --deploy-dev-tools true
    Anmerkung

    Wenn Sie AWS IoT Greengrass auf einem Gerät mit eingeschränktem Speicher ausführen, können Sie die Speichermenge steuern, die die -AWS IoT GreengrassCore-Software verwendet. Um die Speicherzuweisung zu steuern, können Sie Optionen für die JVM-Heap-Größe im jvmOptions Konfigurationsparameter in Ihrer Kernkomponente festlegen. Weitere Informationen finden Sie unter Steuern Sie die Speicherzuweisung mit Optionen JVM.

    Wenn Sie diesen Befehl ausführen, sollten Sie die folgenden Meldungen sehen, um anzuzeigen, dass das Installationsprogramm erfolgreich war.

    Successfully configured Nucleus with provisioned resource details!
Configured Nucleus to deploy aws.greengrass.Cli component
Successfully set up Nucleus as a system service
    Anmerkung

    Wenn Sie über ein Linux-Gerät verfügen und es nicht über systemd verfügt, richtet das Installationsprogramm die Software nicht als Systemservice ein und es wird keine Erfolgsmeldung für die Einrichtung des Kerns als Systemservice angezeigt.