Installieren Sie die AWS IoT Greengrass Core-Software (Konsole)

1. Wählen Sie Nucleus classic als Software-Runtime für Ihr Kerngerät.

2. Wählen Sie das Betriebssystem Ihres Kerngeräts: Linux oder Windows.

3. 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.

   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 im IAM Identity Center-Benutzerhandbuch.

     2. Führen Sie die folgenden Befehle aus, um die Anmeldeinformationen für die AWS IoT Greengrass Core-Software bereitzustellen.

        Linux or UnixWindows Command Prompt (CMD)PowerShell

        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 im IAM-Benutzerhandbuch.

     2. Führen Sie die folgenden Befehle aus, um die Anmeldeinformationen für die AWS IoT Greengrass Core-Software bereitzustellen.

        Linux or UnixWindows Command Prompt (CMD)PowerShell

        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 Weitere Informationen zum Abrufen langfristiger Anmeldeinformationen finden Sie unter Verwaltung von Zugriffsschlüsseln für IAM-Benutzer im IAM-Benutzerhandbuch.

     2. Führen Sie die folgenden Befehle aus, um die Anmeldeinformationen für die AWS IoT Greengrass Core-Software bereitzustellen.

        Linux or UnixWindows Command Prompt (CMD)PowerShell

        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"

     3. (Optional) Wenn Sie einen IAM-Benutzer für die Bereitstellung Ihres Greengrass-Geräts erstellt haben, löschen Sie den Benutzer.

     4. (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.

4. 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.

   2. 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.

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

1. Wählen Sie Nucleus Lite als Software-Runtime für Ihr Kerngerät.

2. 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.

2. 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.

3. Laden Sie das Paket herunter, mit dem die neueste Greengrass Nucleus Lite-Laufzeit auf Ihrem Raspberry Pi installiert wird.

4. 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.

   2. b. Entpacken Sie die Datei greengrass-package.zip im GreengrassInstaller Verzeichnis/auf dem Gerät.

   3. c. Entpacken Sie die ZIP-Datei des Connection Kits im Verzeichnis /auf dem Gerät.

   4. d. Führen Sie zur Installation den bereitgestellten Befehl auf dem Gerät aus AWS IoT Greengrass

5. 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.

2. 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.

3. 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.

   2. Um die Greengrass-Installation zu starten, schalten Sie das Gerät ein und starten Sie es von dem Flash-Image aus

4. 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.

2. 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.

3. 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“.