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. # Schritt 3: Installieren Sie die AWS IoT Greengrass Core-Software **Tipp** Wir empfehlen Ihnen, das [AWS IoT Greengrass AI Agents Context Pack](https://github.com/aws-greengrass/greengrass-agent-context-pack) auszuprobieren, um AWS IoT Greengrass schnell einzurichten und damit zu experimentieren. Das Agent Context Pack ermöglicht es KI-Agenten, Greengrass Nucleus und Nucleus Lite einzurichten, Komponenten bereitzustellen und häufig auftretende Probleme zu beheben. Folgen Sie den Schritten in diesem Abschnitt, um Ihren Raspberry Pi als AWS IoT Greengrass Kerngerät einzurichten, das Sie für die lokale Entwicklung verwenden können. In diesem Abschnitt laden Sie ein Installationsprogramm herunter und führen es aus, das wie folgt vorgeht, um die AWS IoT Greengrass Core-Software für Ihr Gerät zu konfigurieren: + Installiert die Greengrass Nucleus-Komponente. Der Nucleus ist eine obligatorische Komponente und die Mindestanforderung, um die AWS IoT Greengrass Core-Software auf einem Gerät auszuführen. Weitere Informationen finden Sie unter [Greengrass-Kernkomponente](greengrass-nucleus-component.md). + Registriert Ihr Gerät als Objekt AWS IoT und lädt ein digitales Zertifikat herunter, mit dem Ihr Gerät eine Verbindung herstellen AWS kann. Weitere Informationen finden Sie unter [Geräteauthentifizierung und Autorisierung für AWS IoT Greengrass](device-auth.md). + Fügt das AWS IoT Ding des Geräts einer Dinggruppe hinzu, bei der es sich um eine Gruppe oder eine Flotte von AWS IoT Dingen handelt. Mit Dinggruppen können Sie Flotten von Greengrass-Core-Geräten verwalten. Wenn Sie Softwarekomponenten auf Ihren Geräten bereitstellen, können Sie wählen, ob Sie sie auf einzelnen Geräten oder auf Gerätegruppen bereitstellen möchten. Weitere Informationen finden Sie AWS IoT im *AWS IoT Core Entwicklerhandbuch* unter [Geräte verwalten mit](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html). + Erstellt die IAM-Rolle, die es Ihrem Greengrass-Core-Gerät ermöglicht, mit AWS Diensten zu interagieren. Standardmäßig ermöglicht diese Rolle Ihrem Gerät, mit Amazon Logs zu interagieren AWS IoT und Protokolle an Amazon CloudWatch Logs zu senden. Weitere Informationen finden Sie unter [Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS](device-service-role.md). + Installiert die AWS IoT Greengrass Befehlszeilenschnittstelle (`greengrass-cli`), mit der Sie benutzerdefinierte Komponenten testen können, die Sie auf dem Kerngerät entwickeln. Weitere Informationen finden Sie unter [Greengrass-Befehlszeilenschnittstelle](gg-cli.md). # Installieren Sie die AWS IoT Greengrass Core-Software (Konsole) 1. Melden Sie sich an der [AWS IoT Greengrass -Konsole](https://console.aws.amazon.com/greengrass) an. 1. Wählen **Sie unter Erste Schritte mit Greengrass** die Option **Kerngerät einrichten** aus. 1. Geben Sie unter **Schritt 1: Ein Greengrass-Core-Gerät registrieren** unter **Core-Gerätename** den Namen des AWS IoT Geräts für Ihr Greengrass-Core-Gerät ein. Wenn das Ding nicht existiert, erstellt es das Installationsprogramm. 1. Wählen Sie unter **Schritt 2: Zu einer Dinggruppe hinzufügen, um eine kontinuierliche Bereitstellung anzuwenden**, **für Dinggruppe** die AWS IoT Dinggruppe aus, zu der Sie Ihr Kerngerät hinzufügen möchten. + Wenn Sie **Neuen Gruppennamen eingeben** auswählen, geben Sie im Feld **Name der Dinggruppe** den Namen der neuen Gruppe ein, die erstellt werden soll. Das Installationsprogramm erstellt die neue Gruppe für Sie. + Wenn Sie **Vorhandene Gruppe auswählen auswählen wählen**, wählen Sie im **Feld Name der Dinggruppe** die bestehende Gruppe aus, die Sie verwenden möchten. + Wenn Sie **Keine Gruppe** auswählen, fügt das Installationsprogramm das Kerngerät keiner Dinggruppe hinzu. 1. Führen Sie unter **Schritt 3: Installation der Greengrass Core-Software** die folgenden Schritte aus. ------ #### [ Nucleus classic ] 1. Wählen Sie **Nucleus classic** als Software-Runtime für Ihr Kerngerät. 1. Wählen Sie das Betriebssystem Ihres Kerngeräts: **Linux** oder **Windows**. 1. Geben Sie Ihre AWS Anmeldeinformationen für das Gerät ein, damit das Installationsprogramm die AWS IoT und IAM-Ressourcen für Ihr Kerngerät bereitstellen kann. Um die Sicherheit zu erhöhen, empfehlen wir Ihnen, temporäre Anmeldeinformationen für eine IAM-Rolle zu erwerben, die nur die für die Bereitstellung erforderlichen Mindestberechtigungen gewährt. Weitere Informationen finden Sie unter [Minimale IAM-Richtlinie für das Installationsprogramm zur Bereitstellung von Ressourcen](provision-minimal-iam-policy.md). **Anmerkung** Das Installationsprogramm speichert oder speichert Ihre Anmeldeinformationen nicht. Führen Sie auf Ihrem Gerät einen der folgenden Schritte aus, um die Anmeldeinformationen abzurufen und sie dem AWS IoT Greengrass Core-Software-Installationsprogramm zur Verfügung zu stellen: + (Empfohlen) Verwenden Sie temporäre Anmeldeinformationen von AWS IAM Identity Center 1. Geben Sie die Zugriffsschlüssel-ID, den geheimen Zugriffsschlüssel und das Sitzungstoken aus dem IAM Identity Center ein. Weitere Informationen finden Sie unter **Manuelles Aktualisieren von Anmeldeinformationen im Abschnitt** [Temporäre Anmeldeinformationen abrufen und aktualisieren](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) im *IAM Identity Center-Benutzerhandbuch*. 1. Führen Sie die folgenden Befehle aus, um die Anmeldeinformationen für die AWS IoT Greengrass Core-Software bereitzustellen. ------ #### [ Linux or Unix ] ``` export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE= ``` ------ #### [ Windows Command Prompt (CMD) ] ``` set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE= ``` ------ #### [ PowerShell ] ``` $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE=" ``` ------ + Verwenden Sie temporäre Sicherheitsanmeldeinformationen aus einer IAM-Rolle: 1. Geben Sie die Zugriffsschlüssel-ID, den geheimen Zugriffsschlüssel und das Sitzungstoken aus einer IAM-Rolle an, die Sie annehmen. Weitere Informationen zum Abrufen dieser Anmeldeinformationen finden Sie unter [Temporäre Sicherheitsanmeldeinformationen anfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html) im *IAM-Benutzerhandbuch*. 1. Führen Sie die folgenden Befehle aus, um die Anmeldeinformationen für die AWS IoT Greengrass Core-Software bereitzustellen. ------ #### [ Linux or Unix ] ``` export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE= ``` ------ #### [ Windows Command Prompt (CMD) ] ``` set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE= ``` ------ #### [ PowerShell ] ``` $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE=" ``` ------ + Verwenden Sie langfristige Anmeldeinformationen von einem IAM-Benutzer: 1. Geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel für Ihren IAM-Benutzer an. Sie können einen IAM-Benutzer für die Bereitstellung erstellen, den Sie später löschen. Informationen zur IAM-Richtlinie, die dem Benutzer zur Verfügung gestellt werden soll, finden Sie unter. [Minimale IAM-Richtlinie für das Installationsprogramm zur Bereitstellung von Ressourcen](provision-minimal-iam-policy.md) Weitere Informationen zum Abrufen langfristiger Anmeldeinformationen finden Sie unter [Verwaltung von Zugriffsschlüsseln für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *IAM-Benutzerhandbuch*. 1. Führen Sie die folgenden Befehle aus, um die Anmeldeinformationen für die AWS IoT Greengrass Core-Software bereitzustellen. ------ #### [ Linux or Unix ] ``` export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY ``` ------ #### [ Windows Command Prompt (CMD) ] ``` set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY ``` ------ #### [ PowerShell ] ``` $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" ``` ------ 1. (Optional) Wenn Sie einen IAM-Benutzer für die Bereitstellung Ihres Greengrass-Geräts erstellt haben, löschen Sie den Benutzer. 1. (Optional) Wenn Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel eines vorhandenen IAM-Benutzers verwendet haben, aktualisieren Sie die Schlüssel für den Benutzer, sodass sie nicht mehr gültig sind. Weitere Informationen finden Sie im *AWS Identity and Access Management Benutzerhandbuch* unter [Aktualisieren von Zugriffsschlüsseln](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey). 1. **Führen Sie unter Das Installationsprogramm** ausführen die folgenden Schritte aus. 1. Wählen **Sie unter Das Installationsprogramm herunterladen die** Option **Kopieren** aus und führen Sie den kopierten Befehl auf Ihrem Hauptgerät aus. Mit diesem Befehl wird die neueste Version der AWS IoT Greengrass Core-Software heruntergeladen und auf Ihrem Gerät entpackt. 1. Wählen **Sie unter Das Installationsprogramm ausführen die** Option **Kopieren** aus und führen Sie den kopierten Befehl auf Ihrem Core-Gerät aus. Dieser Befehl verwendet die Namen der AWS IoT Dinge und der Dinggruppen, die Sie zuvor angegeben haben, um das AWS IoT Greengrass Core-Softwareinstallationsprogramm auszuführen und AWS Ressourcen für Ihr Kerngerät einzurichten. Dieser Befehl führt außerdem Folgendes aus: + Richten Sie die AWS IoT Greengrass Core-Software als Systemdienst ein, der beim Booten ausgeführt wird. Auf Linux-Geräten erfordert dies das [Systemd-Init-System](https://en.wikipedia.org/wiki/Systemd). **Wichtig** Auf Windows Core-Geräten müssen Sie die AWS IoT Greengrass Core-Software als Systemdienst einrichten. + Stellen Sie die [AWS IoT Greengrass CLI-Komponente](gg-cli.md) bereit, ein Befehlszeilentool, mit dem Sie benutzerdefinierte Greengrass-Komponenten auf dem Kerngerät entwickeln können. + Geben Sie an, dass der `ggc_user` Systembenutzer zur Ausführung von Softwarekomponenten auf dem Kerngerät verwendet werden soll. Auf Linux-Geräten gibt dieser Befehl auch an, dass die `ggc_group` Systemgruppe verwendet werden soll, und das Installationsprogramm erstellt den Systembenutzer und die Systemgruppe für Sie. Wenn Sie diesen Befehl ausführen, sollten Sie die folgenden Meldungen sehen, die darauf hinweisen, dass die Installation 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 ein Linux-Gerät haben und es nicht über [Systemd](https://en.wikipedia.org/wiki/Systemd) verfügt, richtet das Installationsprogramm die Software nicht als Systemdienst ein, und die Erfolgsmeldung für die Einrichtung des Nucleus als Systemdienst wird nicht angezeigt. ------ #### [ Nucleus lite ] 1. Wählen Sie **Nucleus Lite** als Software-Runtime für Ihr Kerngerät. 1. Wählen Sie Ihre Geräteeinrichtungsmethode aus, um Ihr Gerät für ein Greengrass-Core-Gerät bereitzustellen. **Option 1: Richten Sie ein Gerät mit Paket-Download ein (ca. 1 MB)** 1. Erstelle ein AWS IoT Ding und die Rolle für Greengrass. 1. Laden Sie die ZIP-Datei herunter, die AWS IoT Ressourcen enthält, mit denen Ihr Gerät eine Verbindung herstellen muss AWS IoT: + Ein Zertifikat und ein privater Schlüssel, die mithilfe AWS IoT der Zertifizierungsstelle generiert wurden. + Eine Schemadatei, um die Greengrass-Installation für Ihr Gerät zu initiieren. 1. Laden Sie das Paket herunter, mit dem die neueste Greengrass Nucleus Lite-Laufzeit auf Ihrem Raspberry Pi installiert wird. 1. Richten Sie Ihr Gerät als AWS IoT Greengrass Core-Gerät ein und verbinden Sie es mit: AWS IoT 1. a. Übertragen Sie das Greengrass-Paket und das Verbindungskit mit einem USB-Stick, SCP/FTP oder SD-Karten auf Ihr Gerät. 1. b. Entpacken Sie die Datei greengrass-package.zip im GreengrassInstaller Verzeichnis/auf dem Gerät. 1. c. Entpacken Sie die ZIP-Datei des Connection Kits im Verzeichnis /auf dem Gerät. 1. d. Führen Sie zur Installation den bereitgestellten Befehl auf dem Gerät aus AWS IoT Greengrass 1. Wählen Sie dann „**Kerngeräte anzeigen**“. **Option 2: Richten Sie ein Gerät mit einem vorkonfigurierten Beispiel-Image-Download für die gesamte Festplatte ein (ca. 100 MB)** 1. Erstelle ein AWS IoT Ding und die Rolle für Greengrass. 1. Laden Sie die ZIP-Datei herunter, die AWS IoT Ressourcen enthält, mit denen Ihr Gerät eine Verbindung herstellen muss AWS IoT: + Ein Zertifikat und ein privater Schlüssel, die mithilfe AWS IoT der Zertifizierungsstelle generiert wurden. + Eine Schemadatei, um die Greengrass-Installation für Ihr Gerät zu initiieren. 1. Laden Sie das vorkonfigurierte Beispiel-Image für die gesamte Festplatte herunter, das Greengrass und das Betriebssystem enthält. 1. Folgen Sie der Readme-Datei, die zusammen mit dem Image heruntergeladen wurde, um das Verbindungskit zu übertragen und das Image auf Ihr Gerät zu flashen. 1. Um die Greengrass-Installation zu starten, schalten Sie das Gerät ein und starten Sie es von dem Flash-Image aus 1. Wählen Sie dann „**Kerngeräte anzeigen**“. **Option 3: Richten Sie ein Gerät mit Ihrem eigenen Build ein** 1. Erstelle ein AWS IoT Ding und die Rolle für Greengrass. 1. Laden Sie die ZIP-Datei herunter, die AWS IoT Ressourcen enthält, mit denen Ihr Gerät eine Verbindung herstellen muss AWS IoT: + Ein Zertifikat und ein privater Schlüssel, die mithilfe AWS IoT der Zertifizierungsstelle generiert wurden. + Eine Schemadatei, um die Greengrass-Installation für Ihr Gerät zu initiieren. 1. Um Ihr eigenes Image mit Yocto aus dem Quellcode anzupassen und zu erstellen und anschließend das Verbindungskit zur Installation von Nucleus Lite zu verwenden, folgen Sie den Anweisungen unter. GitHub 1. Wählen Sie dann „**Kerngeräte anzeigen**“. ------ # Installieren Sie die AWS IoT Greengrass Core-Software (CLI) **Anmerkung** Diese Schritte gelten nicht für Nucleus Lite. **Um die AWS IoT Greengrass Core-Software zu installieren und zu konfigurieren** 1. Führen Sie auf Ihrem Greengrass-Core-Gerät den folgenden Befehl aus, um zum Home-Verzeichnis zu wechseln. ------ #### [ Linux or Unix ] ``` cd ~ ``` ------ #### [ Windows Command Prompt (CMD) ] ``` cd %USERPROFILE% ``` ------ #### [ PowerShell ] ``` cd ~ ``` ------ 1. Laden Sie auf Ihrem Core-Gerät die AWS IoT Greengrass Core-Software in eine Datei mit dem Namen `greengrass-nucleus-latest.zip` herunter. ------ #### [ 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](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) zu. 1. Entpacken Sie die AWS IoT Greengrass Core-Software in einen Ordner auf Ihrem Gerät. *GreengrassInstaller*Ersetzen Sie es durch 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 ``` ------ 1. 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 Kerngerät für den Betrieb benötigt. + Richten Sie die AWS IoT Greengrass Core-Software als Systemdienst ein, der beim Booten ausgeführt wird. Auf Linux-Geräten erfordert dies das [Systemd-Init-System](https://en.wikipedia.org/wiki/Systemd). **Wichtig** Auf Windows Core-Geräten müssen Sie die AWS IoT Greengrass Core-Software als Systemdienst einrichten. + Stellen Sie die [AWS IoT Greengrass CLI-Komponente](gg-cli.md) bereit. Dabei handelt es sich um ein Befehlszeilentool, mit dem Sie benutzerdefinierte Greengrass-Komponenten auf dem Kerngerät entwickeln können. + Geben Sie an, dass der `ggc_user` Systembenutzer zur Ausführung von Softwarekomponenten auf dem Kerngerät verwendet werden soll. Auf Linux-Geräten gibt dieser Befehl auch an, dass die `ggc_group` Systemgruppe verwendet werden soll, 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:\$1greengrass\$1v2*: Der Pfad zum Stammordner, der für die Installation der AWS IoT Greengrass Core-Software verwendet werden soll. 1. *GreengrassInstaller*. Der Pfad zu dem Ordner, in den Sie das AWS IoT Greengrass Core-Softwareinstallationsprogramm entpackt haben. 1. *region*. Das, AWS-Region in dem Ressourcen gefunden oder erstellt werden sollen. 1. *MyGreengrassCore*. Der Name der AWS IoT Sache für Ihr Greengrass-Core-Gerät. Wenn das Ding nicht existiert, erstellt es das Installationsprogramm. Das Installationsprogramm lädt die Zertifikate herunter, um sich als das AWS IoT Ding zu authentifizieren. Weitere Informationen finden Sie unter [Geräteauthentifizierung und Autorisierung für AWS IoT Greengrass](device-auth.md). **Anmerkung** Der Name der Sache darf keine Doppelpunkte (`:`) enthalten. 1. *MyGreengrassCoreGroup*. Der Name der AWS IoT Dinggruppe für Ihr Greengrass-Core-Gerät. Wenn die Dinggruppe nicht existiert, erstellt das Installationsprogramm sie und fügt ihr das Ding hinzu. Wenn die Dinggruppe vorhanden ist und über eine aktive Bereitstellung verfügt, lädt das Kerngerät die in der Bereitstellung angegebene Software herunter und führt sie aus. **Anmerkung** Der Name der Dinggruppe darf keine Doppelpunkte (`:`) enthalten. 1. *GreengrassV2IoTThingPolicy*. Der Name der AWS IoT Richtlinie, die es den Greengrass-Core-Geräten ermöglicht, mit AWS IoT und AWS IoT Greengrass zu kommunizieren. Wenn die AWS IoT Richtlinie nicht existiert, erstellt das Installationsprogramm eine zulässige 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 V2 Kerngeräte](device-auth.md#greengrass-core-minimal-iot-policy). 1. *GreengrassV2TokenExchangeRole*. Der Name der IAM-Rolle, die es dem Greengrass-Core-Gerät ermöglicht, temporäre AWS Anmeldeinformationen abzurufen. Wenn die Rolle nicht existiert, erstellt das Installationsprogramm sie und erstellt und fügt eine Richtlinie mit dem Namen hinzu. `GreengrassV2TokenExchangeRoleAccess` Weitere Informationen finden Sie unter [Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS](device-service-role.md). 1. *GreengrassCoreTokenExchangeRoleAlias*. Der Alias für die IAM-Rolle, der es dem Greengrass-Core-Gerät ermöglicht, später temporäre Anmeldeinformationen abzurufen. Wenn der Rollenalias nicht existiert, erstellt ihn das Installationsprogramm 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](device-service-role.md). ------ #### [ 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 begrenztem Arbeitsspeicher arbeiten, können Sie die Speichermenge steuern, die die AWS IoT Greengrass Core-Software verwendet. Um die Speicherzuweisung zu steuern, können Sie im `jvmOptions` Konfigurationsparameter Ihrer Nucleus-Komponente die Optionen für die JVM-Heap-Größe festlegen. Weitere Informationen finden Sie unter [Steuern Sie die Speicherzuweisung mit JVM-Optionen](configure-greengrass-core-v2.md#jvm-tuning). Wenn Sie diesen Befehl ausführen, sollten Sie die folgenden Meldungen sehen, die darauf hinweisen, dass die Installation 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 ein Linux-Gerät haben und es nicht über [Systemd](https://en.wikipedia.org/wiki/Systemd) verfügt, richtet das Installationsprogramm die Software nicht als Systemdienst ein, und die Erfolgsmeldung für die Einrichtung des Nucleus als Systemdienst wird nicht angezeigt. # (Optional) Führen Sie die Greengrass-Software aus (Linux) **Anmerkung** Diese Schritte gelten nicht für Nucleus Lite. Wenn Sie die Software als Systemdienst installiert haben, führt das Installationsprogramm die Software für Sie aus. Andernfalls müssen Sie die Software ausführen. Um zu sehen, ob das Installationsprogramm die Software als Systemdienst eingerichtet hat, suchen Sie in der Ausgabe des Installationsprogramms nach der folgenden Zeile. ``` Successfully set up Nucleus as a system service ``` Wenn Sie diese Meldung nicht sehen, gehen Sie wie folgt vor, um die Software auszuführen: 1. Führen Sie den folgenden Befehl aus, um die Software auszuführen. ``` sudo /greengrass/v2/alts/current/distro/bin/loader ``` Die Software druckt die folgende Meldung, wenn sie erfolgreich gestartet wurde. ``` Launched Nucleus successfully. ``` 1. Sie müssen die aktuelle Befehlsshell geöffnet lassen, damit die AWS IoT Greengrass Core-Software weiter ausgeführt werden kann. Wenn Sie SSH verwenden, um eine Verbindung zum Core-Gerät herzustellen, führen Sie den folgenden Befehl auf Ihrem Entwicklungscomputer aus, um eine zweite SSH-Sitzung zu öffnen, mit der Sie zusätzliche Befehle auf dem Core-Gerät ausführen können. *username*Ersetzen Sie es durch den Namen des Benutzers, der sich anmelden soll, und *pi-ip-address* ersetzen Sie es durch die IP-Adresse des Geräts. ``` ssh username@pi-ip-address ``` Weitere Informationen zur Interaktion mit dem Greengrass-Systemdienst finden Sie unter[Den Greengrass Nucleus als Systemdienst konfigurieren](configure-greengrass-core-v2.md#configure-system-service). # Überprüfen Sie die Greengrass CLI-Installation auf dem Gerät **Anmerkung** Diese Schritte gelten nicht für Nucleus Lite. Die Bereitstellung der Greengrass-CLI kann bis zu einer Minute dauern. Führen Sie den folgenden Befehl aus, um den Status der Bereitstellung zu überprüfen. *MyGreengrassCore*Ersetzen Sie ihn durch den Namen Ihres Kerngeräts. ``` aws greengrassv2 list-effective-deployments --core-device-thing-name MyGreengrassCore ``` Das `coreDeviceExecutionStatus` gibt den Status der Bereitstellung auf dem Kerngerät an. Wenn der Status lautet`SUCCEEDED`, führen Sie den folgenden Befehl aus, um zu überprüfen, ob die Greengrass-CLI installiert ist und ausgeführt wird. `/greengrass/v2`Ersetzen Sie ihn durch den Pfad zum Stammordner. ------ #### [ Linux or Unix ] ``` /greengrass/v2/bin/greengrass-cli help ``` ------ #### [ Windows Command Prompt (CMD) ] ``` C:\greengrass\v2\bin\greengrass-cli help ``` ------ #### [ PowerShell ] ``` C:\greengrass\v2\bin\greengrass-cli help ``` ------ Der Befehl gibt Hilfeinformationen für die Greengrass-CLI aus. Wenn das `greengrass-cli` nicht gefunden wird, konnte die Greengrass-CLI bei der Bereitstellung möglicherweise nicht installiert werden. Weitere Informationen finden Sie unter [Problembehebung AWS IoT Greengrass V2](troubleshooting.md). Sie können auch den folgenden Befehl ausführen, um die AWS IoT Greengrass CLI manuell auf Ihrem Gerät bereitzustellen. + *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden. Stellen Sie sicher, dass Sie dasselbe verwenden AWS-Region , das Sie zur Konfiguration AWS CLI auf Ihrem Gerät verwendet haben. + Ersetze es *account-id* durch deine AWS-Konto ID. + *MyGreengrassCore*Ersetzen Sie es durch den Namen Ihres Kerngeräts. ------ #### [ Linux, macOS, or Unix ] ``` aws greengrassv2 create-deployment \ --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" \ --components '{ "aws.greengrass.Cli": { "componentVersion": "2.17.0" } }' ``` ------ #### [ Windows Command Prompt (CMD) ] ``` aws greengrassv2 create-deployment ^ --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ^ --components "{\"aws.greengrass.Cli\":{\"componentVersion\":\"2.17.0\"}}" ``` ------ #### [ PowerShell ] ``` aws greengrassv2 create-deployment ` --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ` --components '{\"aws.greengrass.Cli\":{\"componentVersion\":\"2.17.0\"}}' ``` ------ **Tipp** Sie können Ihrer `PATH` Umgebungsvariablen `/greengrass/v2/bin` (Linux) oder `C:\greengrass\v2\bin` (Windows) hinzufügen, um sie `greengrass-cli` ohne ihren absoluten Pfad auszuführen. Die AWS IoT Greengrass Core-Software und die lokalen Entwicklungstools werden auf Ihrem Gerät ausgeführt. Als Nächstes können Sie eine Hello AWS IoT Greengrass World-Komponente auf Ihrem Gerät entwickeln.