

Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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 la   Kit SDK des appareils AWS IoT pour Python
<a name="IoT-SDK"></a>

Les appareils clients peuvent utiliser le Kit SDK des appareils AWS IoT for Python pour communiquer avec AWS IoT les périphériques AWS IoT Greengrass principaux (à l'aide du langage de programmation Python). Pour plus d'informations, y compris les exigences, consultez le [fichier Readme Kit SDK des appareils AWS IoT](https://github.com/aws/aws-iot-device-sdk-python) pour Python sur GitHub.

Au cours de cette étape, vous installez le SDK et obtenez l'`basicDiscovery.py`exemple de fonction utilisé 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é](https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx) 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](https://wiki.python.org/moin/BeginnersGuide/Download) pour installer Python 2.7\+ ou Python 3.3\+. Pour plus d'informations, consultez la page [Using Python on Windows](https://docs.python.org/3.6/using/windows.html).

   1. Téléchargez le fichier [Kit SDK des appareils AWS IoT pour Python](https://github.com/aws/aws-iot-device-sdk-python) sous forme de `zip` fichier et extrayez-le vers un emplacement approprié sur 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 de fichier est indiqué par{{path-to-SDK-folder}}.

   1. À 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](https://wiki.python.org/moin/BeginnersGuide/Download) pour installer Python 2.7\+ ou Python 3.3\+. Pour plus d'informations, consultez la page [Using Python on a Macintosh](https://docs.python.org/3/using/mac.html).

   1. 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](#step-c-install-python-sdk). 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 pyenv ]

      1. Consultez la page des [versions Python pour Mac OS X](https://www.python.org/downloads/mac-osx/) (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}}.

      1. À 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
         ```

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

      1. 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](https://brew.sh/) 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.

      1. Exécutez les commandes suivantes :

         ```
         brew update
         brew install openssl
         brew install python@2
         ```

          Kit SDK des appareils AWS IoT Pour Python, la version 1.0.1 (ou ultérieure) d'OpenSSL doit être compilée avec l'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](https://en.wikipedia.org/wiki/Source_(command)) 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.

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

      1. Ensuite, définissez la [source](https://en.wikipedia.org/wiki/Source_(command)) 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`).

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

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

         ```
          exit()
         ```

------

   1. <a name="step-c-install-python-sdk"></a>Exécutez les commandes suivantes pour installer le Kit SDK des appareils AWS IoT pour 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](https://wiki.python.org/moin/BeginnersGuide/Download) pour installer Python 2.7\+ ou Python 3.3\+. Pour plus d'informations, consultez la page [Using Python on Unix platforms](https://docs.python.org/3.6/using/unix.html).

   1. 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()
      ```

   1. Exécutez les commandes suivantes pour installer le Kit SDK des appareils AWS IoT pour 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
      ```

------

1. Une fois le Kit SDK des appareils AWS IoT for Python installé, accédez au `samples` dossier et `greengrass` ouvrez-le.

   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 un AWS IoT Greengrass groupe](device-group.md).

1. Copiez `basicDiscovery.py` dans le dossier contenant les certificats et clés des appareils HelloWorld \_Publisher et HelloWorld \_Subscriber.