Installieren desAWS IoT Device SDKfor Python - AWS IoT Greengrass

AWS IoT Greengrass Version 1 trat am 30. Juni 2023 in die erweiterte Lebensphase ein. Weitere Informationen finden Sie in der AWS IoT Greengrass V1 Wartungsrichtlinie. Nach diesem Datum AWS IoT Greengrass V1 werden keine Updates mehr veröffentlicht, die Funktionen, Verbesserungen, Bugfixes oder Sicherheitspatches bieten. Geräte, die auf laufen, werden AWS IoT Greengrass V1 nicht gestört und funktionieren weiterhin und stellen eine Verbindung zur Cloud her. Wir empfehlen Ihnen dringend, zu migrieren AWS IoT Greengrass Version 2, da dies wichtige neue Funktionen und Unterstützung für zusätzliche Plattformen bietet.

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 desAWS IoT Device SDKfor Python

Client-Geräte können dasAWS IoT Device SDKfür Python zum Kommunizieren mitAWS IoTundAWS IoT Greengrass-Geräte (unter Verwendung der Programmiersprache Python). Weitere Informationen, einschließlich der Voraussetzungen, finden Sie in derAWS IoT Device SDKfor PythonReadmeauf GitHubaus.

In diesem Schritt installieren Sie das SDK und rufen dasbasicDiscovery.py-Beispielfunktion, die von den simulierten Client-Geräten auf Ihrem Computer verwendet wird.

  1. Um das SDK mit allen erforderlichen Komponenten auf Ihrem Computer zu installieren, wählen Sie Ihr Betriebssystem aus:

    Windows
    1. Öffnen Sie eine erweiterte Eingabeaufforderung und führen Sie den folgenden Befehl aus:

      python --version

      Wenn keine Versionsinformationen zurückgegeben werden oder wenn die Versionsnummer für Python 2 kleiner als 2.7 oder für Python 3 kleiner als 3.3 ist, installieren Sie Python 2.7+ oder Python 3.3+ gemäß den Anweisungen unter Downloading Python. Weitere Informationen finden Sie unter Using Python on Windows.

    2. Herunterladen desAWS IoT Device SDKfor Pythonalszip-Datei und extrahieren Sie die Datei zu einem geeigneten Speicherort auf Ihrem Computer.

      Notieren Sie sich den Dateipfad zum extrahierten aws-iot-device-sdk-python-master-Ordner, der die Datei setup.py enthält. Im nächsten Schritt ist dieser Dateipfad als path-to-SDK-folder dargestellt.

    3. Führen Sie von der erweiterten Eingabeaufforderung aus Folgendes aus:

      cd path-to-SDK-folder python setup.py install
    macOS
    1. Öffnen Sie ein Terminalfenster und führen Sie den folgenden Befehl aus:

      python --version

      Wenn keine Versionsinformationen zurückgegeben werden oder wenn die Versionsnummer für Python 2 kleiner als 2.7 oder für Python 3 kleiner als 3.3 ist, installieren Sie Python 2.7+ oder Python 3.3+ gemäß den Anweisungen unter Downloading Python. Weitere Informationen finden Sie unter Using Python on a Macintosh.

    2. Führen Sie im Terminalfenster die folgenden Befehle aus, um die OpenSSL-Version zu ermitteln:

      python >>>import ssl >>>print ssl.OPENSSL_VERSION

      Notieren Sie sich den Wert der OpenSSL-Version.

      Anmerkung

      Wenn Sie Python 3 ausführen, verwenden Sie print(ssl.OPENSSL_VERSION).

      Um die Python-Shell zu schließen, führen Sie den folgenden Befehl aus:

      >>>exit()

      Wenn die OpenSSL Version 1.0.1 oder höher ist, gehen Sie direkt zu Schritt c. Führen Sie andernfalls die folgenden Schritte aus:

      1. Führen Sie im Terminalfenster den folgenden Befehl aus, um zu festzustellen, ob der Computer das Simple Python Version Management verwendet:

        which pyenv

      Wird ein Dateipfad zurückgegeben, wählen Sie die Registerkarte Using pyenv (Unter Verwendung von). Wird nichts zurückgegeben, wählen Sie die Registerkarte Not using pyenv (Nicht unter Verwendung von).

      Using pyenvNot using pyenv
      Using pyenv
      1. Weitere Informationen, wie Sie die neueste stabile Python-Version bestimmen, finden Sie unter Python Releases for Max OS X (oder ähnlich). Im folgenden Beispiel wird dieser Wert durch latest-Python-version dargestellt.

      2. Führen Sie im Terminalfenster die folgenden Befehle aus:

        pyenv install latest-Python-version pyenv global latest-Python-version

        Wenn beispielsweise die neueste Version für Python 2 gleich 2.7.14 ist, lauten diese Befehle:

        pyenv install 2.7.14 pyenv global 2.7.14
      3. Schließen Sie das Terminalfenster und öffnen Sie es wieder und führen Sie dann die folgenden Befehle aus:

        python >>>import ssl >>>print ssl.OPENSSL_VERSION

        Die OpenSSL-Version sollte 1.0.1 oder neuer sein. Wenn die Version kleiner als 1.0.1 ist, dann ist die Aktualisierung fehlgeschlagen. Überprüfen Sie die Python-Version in den Befehlen pyenv install und pyenv global und versuchen Sie es erneut.

      4. Um die Python-Shell zu schließen, führen Sie den folgenden Befehl aus:

        exit()
      Not using pyenv
      1. Führen Sie den folgenden Befehl in einem Terminalfenster aus, um festzustellen, ob brew installiert ist:

        which brew

        Wird kein Dateipfad zurückgegeben, installieren Sie brew wie folgt:

        /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
        Anmerkung

        Befolgen Sie die Eingabeaufforderungen für die Installation. Der Download für die Xcode-Befehlszeilentools kann einige Zeit in Anspruch nehmen.

      2. Führen Sie die folgenden Befehle aus:

        brew update brew install openssl brew install python@2

        DieAWS IoT Device SDKfür Python benötigt OpenSSL-Version 1.0.1 (oder höher), kompiliert mit der Python-Programmdatei. Der obige Befehl brew install python installiert eine ausführbare python2-Datei, die diese Anforderung erfüllt. Die ausführbare python2-Datei wird im Ordner /usr/local/bin installiert, das Teil der Umgebungsvariablen PATH sein sollte. Führen Sie zur Bestätigung den folgenden Befehl aus:

        python2 --version

        Wenn python2-Versionsinformationen bereitgestellt werden, gehen Sie zum nächsten Schritt über. Andernfalls fügen Sie Ihrer Umgebungsvariablen PATH dauerhaft den Pfad /usr/local/bin hinzu, indem Sie Ihrem Shell-Profil die folgende Zeile hinzufügen:

        export PATH="/usr/local/bin:$PATH"

        Wenn Sie beispielsweise .bash_profile verwenden oder noch kein Shell-Profil haben, führen Sie den folgenden Code von einem Terminalfenster aus aus:

        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile

        Anschließend führen Sie source für Ihr Shell-Profil aus und bestätigen, dass python2 --version Versionsinformationen bereitstellt. Wenn Sie z. B. .bash_profile verwenden, führen Sie die folgenden Befehle aus:

        source ~/.bash_profile python2 --version

        python2-Versionsinformationen sollten zurückgegeben werden.

      3. Fügen Sie Ihrem Shell-Profil die folgende Zeile hinzu:

        alias python="python2"

        Wenn Sie beispielsweise .bash_profile verwenden oder noch kein Shell-Profil haben, führen Sie den folgenden Code aus:

        echo 'alias python="python2"' >> ~/.bash_profile
      4. Anschließend führen Sie source für Ihr Shell-Profil aus. Wenn Sie z. B. .bash_profile verwenden, führen Sie den folgenden Befehl aus:

        source ~/.bash_profile

        Wenn der Befehl python aufgerufen wird, wird die Python-Programmdateien ausgeführt, in der die erforderliche OpenSSL-Version (python2) enthalten ist.

      5. Führen Sie die folgenden Befehle aus:

        python import ssl print ssl.OPENSSL_VERSION

        Die OpenSSL-Version sollte 1.0.1 oder neuer sein.

      6. Um die Python-Shell zu schließen, führen Sie den folgenden Befehl aus:

        exit()
    3. Führen Sie den folgenden Befehl aus, um zu installieren:AWS IoT Device SDKfür Python:

      cd ~ git clone https://github.com/aws/aws-iot-device-sdk-python.git cd aws-iot-device-sdk-python sudo python setup.py install
    UNIX-like system
    1. Führen Sie in einem Terminalfenster den folgenden Befehl aus:

      python --version

      Wenn keine Versionsinformationen zurückgegeben werden oder wenn die Versionsnummer für Python 2 kleiner als 2.7 oder für Python 3 kleiner als 3.3 ist, installieren Sie Python 2.7+ oder Python 3.3+ gemäß den Anweisungen unter Downloading Python. Weitere Informationen finden Sie unter Using Python on Unix-Plattformen.

    2. Führen Sie im Terminal die folgenden Befehle aus, um die OpenSSL-Version zu ermitteln:

      python >>>import ssl >>>print ssl.OPENSSL_VERSION

      Notieren Sie sich den Wert der OpenSSL-Version.

      Anmerkung

      Wenn Sie Python 3 ausführen, verwenden Sie print(ssl.OPENSSL_VERSION).

      Um die Python-Shell zu schließen, führen Sie den folgenden Befehl aus:

      exit()

      Wenn die OpenSSL Version 1.0.1 oder höher ist, gehen Sie direkt zum nächsten Schritt. Andernfalls führen Sie den Befehl/die Befehle für die Aktualisierung von OpenSSL für Ihre Verteilung aus (zum Beispiel sudo yum update openssl, sudo apt-get update usw.).

      Vergewissern Sie sich, dass die OpenSSL-Version 1.0.1 oder höher ist, indem Sie die folgenden Befehle ausführen:

      python >>>import ssl >>>print ssl.OPENSSL_VERSION >>>exit()
    3. Führen Sie den folgenden Befehl aus, um zu installieren:AWS IoT Device SDKfür Python:

      cd ~ git clone https://github.com/aws/aws-iot-device-sdk-python.git cd aws-iot-device-sdk-python sudo python setup.py install
  2. Nach demAWS IoT Device SDKfür Python installiert ist, navigieren Sie zusamplesund öffnen Sie dengreengrassfolder.

    Für dieses Tutorial kopieren Sie die basicDiscovery.py-Beispielfunktion, die die Zertifikate und Schlüssel verwendet, die Sie in Erstellen Sie Client-Geräte in einerAWS IoT GreengrassGruppe heruntergeladen haben.

  3. KopierenbasicDiscovery.pyin den Ordner, der die Datei enthält HelloWorld_Publisher und HelloWorld_Abonnentengerätezertifikate und -schlüssel.