Instale el SDK para dispositivos con AWS IoT para Python - AWS IoT Greengrass

AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Instale el SDK para dispositivos con AWS IoT para Python

Los dispositivos cliente pueden utilizar el SDK para dispositivos con AWS IoT para Python para comunicarse con los dispositivos principales AWS IoT y AWS IoT Greengrass (utilizando el lenguaje de programación Python). Para obtener más información, incluidos los requisitos, consulte el SDK para dispositivos con AWS IoT para ver el Readme de Python en GitHub.

En este paso, instalará el SDK y obtendrá la función de ejemplo basicDiscovery.py, que utilizan los dispositivos de cliente simulados en el equipo.

  1. Para instalar el SDK con todos los componentes necesarios en el equipo, elija el sistema operativo:

    Windows

    1. Abra un símbolo del sistema elevado y ejecute el siguiente comando:

      python --version

      Si no devuelve información sobre la versión o si la versión es inferior a 2.7 para Python 2 o a 3.3 para Python 3, siga las instrucciones de la página Downloading Python (Descargar Python) para instalar Python 2.7+ o Python 3.3+. Para obtener más información acerca de los periodos de mantenimiento, consulte Using Python on Windows.

    2. Descargue SDK para dispositivos con AWS IoT para Python como un archivo zip y extráigalo en la ubicación adecuada del equipo.

      Anote la ruta del archivo en la carpeta aws-iot-device-sdk-python-master extraída que contiene el archivo setup.py. En el siguiente paso, ruta-a-carpeta-SDK indica esta ruta.

    3. Ejecute el siguiente comando desde el símbolo del sistema elevado:

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

    1. Abra una ventana de terminal y ejecute el siguiente comando:

      python --version

      Si no devuelve información sobre la versión o si la versión es inferior a 2.7 para Python 2 o a 3.3 para Python 3, siga las instrucciones de la página Downloading Python (Descargar Python) para instalar Python 2.7+ o Python 3.3+. Para obtener más información acerca de los periodos de mantenimiento, consulte Using Python on a Macintosh.

    2. En la ventana de terminal, ejecute los siguientes comandos para determinar la versión de OpenSSL:

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

      Anote el valor de versión de OpenSSL.

      nota

      Si está ejecutando Python 3, use print(ssl.OPENSSL_VERSION).

      Para cerrar manualmente el shell de Python, ejecute el siguiente comando:

      >>>exit()

      Si la versión de OpenSSL es 1.0.1 o posterior, vaya al paso c. De lo contrario, siga estos pasos:

      1. En la ventana de terminal, ejecute el siguiente comando para determinar si el equipo está utilizando Simple Python Version Management:

        which pyenv

      Si devuelve una ruta de archivo, elija la pestaña Con pyenv. Si no devuelve nada, elija la pestaña Sin pyenv.

      Using pyenvNot using pyenv
      Using pyenv

      1. Consulte Python Releases for Mac OS X (o similar) para informarse acerca de la última versión de Python estable. En el ejemplo siguiente, este valor se indica mediante última-versión-de-Python.

      2. En una ventana de terminal, ejecute los siguientes comandos:

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

        Por ejemplo, si la última versión de Python 2 es 2.7.14, estos comandos son:

        pyenv install 2.7.14
pyenv global 2.7.14

      3. Cierre y, a continuación, vuelva a abrir la ventana del terminal y, a continuación, ejecute los comandos siguientes:

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

        La versión de OpenSSL debe ser 1.0.1 o posterior. Si la versión es inferior a 1.0.1, entonces la actualización ha fallado. Compruebe el valor de la versión de Python utilizado en los comandos pyenv global y pyenv install e inténtelo de nuevo.

      4. Ejecute el siguiente comando para cerrar el shell de Python:

         exit()
      Not using pyenv

      1. Desde una ventana de terminal, ejecute el siguiente comando para determinar si brew está instalado.

        which brew

        Si no devuelve una ruta, instale brew de la siguiente manera:

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

        Siga las instrucciones de instalación. La descarga de las herramientas de línea de comandos de Xcode pueden tardar algún tiempo.

      2. Ejecute los comandos siguientes:

        brew update
brew install openssl
brew install python@2

        El SDK para dispositivos con AWS IoT para Python requiere OpenSSL versión 1.0.1 (o posterior) compilado con el ejecutable de Python. El comando brew install python instala un ejecutable python2 que cumple este requisito. El ejecutable python2 se instala en el directorio /usr/local/bin, que debe ser parte de la variable de entorno PATH. Para confirmar, ejecute el siguiente comando:

        python2 --version

        Si se proporciona información de la versión de python2, vaya al siguiente paso. De lo contrario, agregue la siguiente línea a su perfil de shell para añadir de forma permanente la ruta /usr/local/bin a la variable de entorno PATH:

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

        Por ejemplo, si está utilizando .bash_profile o aún no dispone de un perfil de shell, ejecute este comando desde una ventana de terminal:

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

        A continuación, ejecute el comando source en el perfil de shell y compruebe si python2 --version proporciona información de la versión. Por ejemplo, si está utilizando .bash_profile, ejecute los siguientes comandos.

        source ~/.bash_profile
python2 --version

        Debe devolver información de la versión de python2.

      3. Agregue la siguiente línea a su perfil de shell:

        alias python="python2"

        Por ejemplo, si está utilizando .bash_profile o aún no dispone de un perfil de shell, ejecute este comando:

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

      4. A continuación, ejecute el comando source en el perfil de shell. Por ejemplo, si está utilizando .bash_profile, ejecute el siguiente comando:

        source ~/.bash_profile

        Al invocar el comando python se ejecuta el ejecutable de Python que contiene la versión de OpenSSL necesaria (python2).

      5. Ejecute los comandos siguientes:

        python
 import ssl
 print ssl.OPENSSL_VERSION

        La versión de OpenSSL debe ser 1.0.1 o posterior.

      6. Para cerrar el shell de Python, ejecute siguiente comando:

         exit()

    3. Ejecute los siguientes comandos para instalar el SDK para dispositivos con AWS IoT para 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. En una ventana de terminal de , ejecute el siguiente comando:

      python --version

      Si no devuelve información sobre la versión o si la versión es inferior a 2.7 para Python 2 o a 3.3 para Python 3, siga las instrucciones de la página Downloading Python (Descargar Python) para instalar Python 2.7+ o Python 3.3+. Para obtener más información acerca de los periodos de mantenimiento, consulte Using Python on Unix platforms.

    2. En el terminal, ejecute los siguientes comandos para determinar la versión de OpenSSL:

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

      Anote el valor de versión de OpenSSL.

      nota

      Si está ejecutando Python 3, use print(ssl.OPENSSL_VERSION).

      Para cerrar manualmente el shell de Python, ejecute el siguiente comando:

       exit()

      Si la versión de OpenSSL es 1.0.1 o posterior, vaya al paso siguiente. De lo contrario, ejecute los comandos necesarios para actualizar OpenSSL según su distribución (por ejemplo, sudo yum update openssl, sudo apt-get update, etc.).

      Ejecute los siguientes comandos para determinar si la versión de OpenSSL es 1.0.1 o posterior:

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

    3. Ejecute los siguientes comandos para instalar el SDK para dispositivos con AWS IoT para 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. Una vez que el SDK para dispositivos con AWS IoT para Python esté instalado, vaya a la carpeta samples y abra la carpeta greengrass.

    Para este tutorial, copiará la función basicDiscovery.py de ejemplo, que utiliza los certificados y las claves que ha descargado en Creación de dispositivos de en un grupo de AWS IoT Greengrass.

  3. Copie basicDiscovery.py en la carpeta que contiene las claves y certificados de dispositivo HelloWorld_Publisher y HelloWorld_Subscriber.