Installer leKit SDK des appareils AWS IoTpour Python - AWS IoT Greengrass

AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Installer leKit SDK des appareils AWS IoTpour Python

Les appareils clients peuvent utiliserKit SDK des appareils AWS IoTpour Python pour communiquer avecAWS IoTetAWS IoT Greengrassappareils principaux (à l'aide du langage de programmation Python). Pour en savoir plus, notamment les exigences, consultez le kitKit SDK des appareils AWS IoTpour PythonReadmesur GitHub.

Dans cette étape, vous installez le kit SDK et obtenez le kitbasicDiscovery.pyexemple de fonction utilisée par les appareils clients simulés sur votre ordinateur.

  1. Pour installer le kit SDK sur votre ordinateur, avec tous les composants nécessaires, choisissez votre système d'exploitation :

    Windows

    1. Ouvrez une invite de commande de niveau élevé et exécutez la commande suivante :

      python --version

      Si aucune information de version n'est renvoyée ou si le numéro de version est inférieur à 2.7 pour Python 2 ou à 3.3 pour Python 3, suivez les instructions indiquées à la page Downloading Python pour installer Python 2.7+ ou Python 3.3+. Pour plus d'informations, consultez la page Using Python on Windows.

    2. Télécharger leKit SDK des appareils AWS IoTpour Pythonen tant quezipet extrayez-le sur un emplacement approprié de votre ordinateur.

      Notez le chemin d'accès au dossier aws-iot-device-sdk-python-master extrait qui contient le fichier setup.py. À l'étape suivante, ce chemin d'accès sera indiqué par path-to-SDK-folder.

    3. À partir d'une invite de commande de niveau élevé, exécutez la commande suivante :

      cd path-to-SDK-folder
python setup.py install
    macOS

    1. Ouvrez une fenêtre de terminal et exécutez la commande suivante :

      python --version

      Si aucune information de version n'est renvoyée ou si le numéro de version est inférieur à 2.7 pour Python 2 ou à 3.3 pour Python 3, suivez les instructions indiquées à la page Downloading Python pour installer Python 2.7+ ou Python 3.3+. Pour plus d'informations, consultez la page Using Python on a Macintosh.

    2. Dans la fenêtre de terminal, exécutez les commandes suivantes pour déterminer la version OpenSSL :

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

      Notez la valeur de la version OpenSSL.

      Note

      Si vous exécutez Python 3, utilisez print(ssl.OPENSSL_VERSION).

      Pour fermer le shell Python, exécutez la commande suivante :

      >>>exit()

      Si la version OpenSSL est postérieure à 1.0.1, passez directement à l'étape 3. Sinon, suivez ces étapes :

      1. Depuis la fenêtre de terminal, exécutez la commande suivante afin de déterminer si l'ordinateur utilise Simple Python Version Management :

        which pyenv

      Si un chemin d'accès est renvoyé, choisissez l'onglet Using (Utilise) pyenv. Si aucun chemin n'est renvoyé, choisissez l'onglet Not using (N'utilise pas) pyenv.

      Using pyenvNot using pyenv
      Using pyenv

      1. Consultez la page des versions Python pour Mac OS X (ou similaire) pour déterminer la version stable de Python la plus récente. Dans l'exemple suivant, cette valeur est indiquée par latest-Python-version.

      2. À partir de la fenêtre de terminal, exécutez les commandes suivantes :

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

        Par exemple, si la version la plus récente de Python 2 est 2.7.14, ces commandes seront les suivantes :

        pyenv install 2.7.14
pyenv global 2.7.14

      3. Fermez, puis rouvrez une fenêtre de terminal et exécutez les commandes suivantes :

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

        La version OpenSSL doit être au minimum 1.0.1. Si la version est inférieure à 1.0.1, la mise à jour a échoué. Vérifiez la version de Python utilisée dans les commandes pyenv install et pyenv global, puis réessayez.

      4. Pour quitter le shell Python, exécutez la commande suivante :

         exit()
      Not using pyenv

      1. À partir d'une fenêtre de terminal, exécutez la commande suivante pour déterminer si brew est installé :

        which brew

        Si aucun chemin d'accès n'est renvoyé, installez brew comme suit :

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

        Suivez les invites d'installation. Le téléchargement des outils de ligne de commande Xcode peut prendre un certain temps.

      2. Exécutez les commandes suivantes :

        brew update
brew install openssl
brew install python@2

        LeKit SDK des appareils AWS IoTpour Python nécessite la version OpenSSL 1.0.1 (ou ultérieure) compilée avec le fichier exécutable Python. La commande brew install python installe un fichier exécutable python2 qui répond à cette exigence. Le fichier exécutable python2 est installé dans le répertoire /usr/local/bin, qui doit faire partie de la variable d'environnement PATH. Pour confirmer cela, exécutez la commande suivante :

        python2 --version

        Si des informations sur la version python2 sont fournies, passez directement à l'étape suivante. Dans le cas contraire, ajoutez de façon définitive le chemin /usr/local/bin à votre variable d'environnement PATH en ajoutant la ligne suivante à votre profil shell :

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

        Par exemple, si vous utilisez .bash_profile ou si vous ne possédez pas encore de profil shell, exécutez la commande suivante à partir d'une fenêtre de terminal :

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

        Ensuite, définissez la source de votre profil shell et confirmez que les informations de version sont fournies par python2 --version. Par exemple, si vous utilisez .bash_profile, exécutez les commandes suivantes :

        source ~/.bash_profile
python2 --version

        Les informations de version python2 doivent être renvoyées.

      3. Ajoutez la ligne suivante à votre profil shell :

        alias python="python2"

        Par exemple, si vous utilisez .bash_profile ou si vous ne possédez pas encore de profil shell, exécutez la commande suivante :

        echo 'alias python="python2"' >> ~/.bash_profile

      4. Ensuite, définissez la source de votre profil shell. Par exemple, si vous utilisez .bash_profile, exécutez la commande suivante :

        source ~/.bash_profile

        L'appel de la commande python a pour effet de lancer le fichier exécutable Python contenant la version OpenSSL requise (python2).

      5. Exécutez les commandes suivantes :

        python
 import ssl
 print ssl.OPENSSL_VERSION

        La version OpenSSL doit être 1.0.1 ou une version ultérieure.

      6. Pour quitter le shell Python, exécutez la commande suivante :

         exit()

    3. Exécutez les commandes suivantes pour installer le kitKit SDK des appareils AWS IoTpour 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. À partir d'une fenêtre de terminal , exécutez la commande suivante :

      python --version

      Si aucune information de version n'est renvoyée ou si le numéro de version est inférieur à 2.7 pour Python 2 ou à 3.3 pour Python 3, suivez les instructions indiquées à la page Downloading Python pour installer Python 2.7+ ou Python 3.3+. Pour plus d'informations, consultez la page Using Python on Unix platforms.

    2. Dans la fenêtre de terminal, exécutez les commandes suivantes pour déterminer la version OpenSSL :

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

      Notez la valeur de la version OpenSSL.

      Note

      Si vous exécutez Python 3, utilisez print(ssl.OPENSSL_VERSION).

      Pour fermer le shell Python, exécutez la commande suivante :

       exit()

      Si la version OpenSSL est postérieure à 1.0.1, passez directement à l'étape suivante. Dans le cas contraire, exécutez la ou les commandes pour mettre à jour OpenSSL pour votre distribution (par exemple, sudo yum update openssl, sudo apt-get update, etc.).

      Confirmez que la version OpenSSL est bien 1.0.1 ou une version ultérieure en exécutant les commandes suivantes :

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
>>>exit()

    3. Exécutez les commandes suivantes pour installer le kitKit SDK des appareils AWS IoTpour 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. Après leKit SDK des appareils AWS IoTpour Python est installé, accédez àsampleset ouvrez le dossiergreengrassfolder.

    Pour ce didacticiel, vous copiez l'exemple de fonction basicDiscovery.py, qui utilise les certificats et les clés que vous avez téléchargés dans Créez des appareils clients dans unAWS IoT Greengrassgroupe.

  3. CopierbasicDiscovery.pydans le dossier qui contient le fichier HelloWorld_Publisher et HelloWorldCertificats et clés de l'appareil _Abonné.