Paso 2: Configure su entorno - AWS IoT Greengrass

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.

Paso 2: Configure su entorno

Siga los pasos de esta sección para configurar un dispositivo Linux o Windows para usarlo como dispositivo AWS IoT Greengrass principal.

En estos pasos se supone que utilizas una Raspberry Pi con el sistema operativo Raspberry Pi. Si utilizas un dispositivo o sistema operativo diferente, consulta la documentación correspondiente a tu dispositivo.

Para configurar una Raspberry Pi para AWS IoT Greengrass V2

  1. Activa SSH en tu Raspberry Pi para conectarte a ella de forma remota. Para obtener más información, consulte SSH (Secure shell) en la documentación de Raspberry Pi.

  2. Busca la dirección IP de tu Raspberry Pi para conectarte a ella mediante SSH. Para ello, puedes ejecutar el siguiente comando en tu Raspberry Pi.

    hostname -I

  3. Conéctate a tu Raspberry Pi con SSH.

    En tu ordenador de desarrollo, ejecuta el siguiente comando. Sustituya el nombre de usuario por el nombre del usuario para iniciar sesión y pi-ip-addresssustitúyalo por la dirección IP que encontró en el paso anterior.

    ssh username@pi-ip-address
    importante

    Si tu equipo de desarrollo usa una versión anterior de Windows, es posible que no tengas el ssh comando o que lo tengas ssh pero no puedas conectarte a tu Raspberry Pi. Para conectarte a tu Raspberry Pi, puedes instalar y configurar PuTTY, que es un cliente SSH de código abierto y gratuito. Consulta la documentación de PuTTY para conectarte a tu Raspberry Pi.

  4. Instala el motor de ejecución de Java, que el software AWS IoT Greengrass Core necesita para ejecutarse. En tu Raspberry Pi, usa los siguientes comandos para instalar Java 11.

    sudo apt install default-jdk

    Cuando se complete la instalación, ejecuta el siguiente comando para comprobar que Java se ejecuta en tu Raspberry Pi.

    java -version

    El comando imprime la versión de Java que se ejecuta en el dispositivo. El resultado puede tener un aspecto similar al del siguiente ejemplo.

    openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)
Consejo: Defina los parámetros del núcleo en una Raspberry Pi

Si su dispositivo es una Raspberry Pi, puede completar los siguientes pasos para ver y actualizar los parámetros del núcleo de Linux:

  1. Abra el archivo /boot/cmdline.txt. Este archivo especifica los parámetros del núcleo de Linux que se aplicarán al arrancar la Raspberry Pi.

    Por ejemplo, en un sistema basado en Linux, puede ejecutar el siguiente comando para usar GNU nano y abrir el archivo.

    sudo nano /boot/cmdline.txt

  2. Compruebe que el /boot/cmdline.txt archivo contiene los siguientes parámetros del núcleo. El systemd.unified_cgroup_hierarchy=0 parámetro especifica el uso de cgroups v1 en lugar de cgroups v2.

    cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

    Si el /boot/cmdline.txt archivo no contiene estos parámetros o los contiene con valores diferentes, actualice el archivo para que contenga estos parámetros y valores.

  3. Si ha actualizado el /boot/cmdline.txt archivo, reinicie la Raspberry Pi para aplicar los cambios.

    sudo reboot
Para configurar un dispositivo Linux para AWS IoT Greengrass V2

  1. Instale el motor de ejecución de Java, que el software AWS IoT Greengrass principal necesita para ejecutarse. Le recomendamos que utilice las versiones de soporte a largo plazo de Amazon Corretto u OpenJDK. Se requiere la versión 8 o superior. Los siguientes comandos muestran cómo instalar OpenJDK en su dispositivo.

    • Para distribuciones basadas en Debian o en Ubuntu:

      sudo apt install default-jdk

    • Para distribuciones basadas en Red Hat:

      sudo yum install java-11-openjdk-devel

    • En Amazon Linux 2:

      sudo amazon-linux-extras install java-openjdk11

    • Para Amazon Linux 2023:

      sudo dnf install java-11-amazon-corretto -y

    Cuando se complete la instalación, ejecute el siguiente comando para comprobar que Java se ejecuta en su dispositivo Linux.

    java -version

    El comando imprime la versión de Java que se ejecuta en el dispositivo. Por ejemplo, en una distribución basada en Debian, el resultado podría tener un aspecto similar al del siguiente ejemplo.

    openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

  2. (Opcional) Cree el usuario y el grupo predeterminados del sistema que ejecutan los componentes del dispositivo. También puede optar por permitir que el instalador del software AWS IoT Greengrass principal cree este usuario y grupo durante la instalación con el argumento del --component-default-user instalador. Para obtener más información, consulte Argumentos de instalación.

    sudo useradd --system --create-home ggc_user
sudo groupadd --system ggc_group

  3. Compruebe que el usuario que ejecuta el software AWS IoT Greengrass principal (normalmenteroot) tiene permiso para ejecutar sudo con cualquier usuario y grupo.

    1. Ejecute el siguiente comando para abrir el /etc/sudoers archivo.

      sudo visudo

    2. Compruebe que el permiso del usuario es similar al del ejemplo siguiente.

      root    ALL=(ALL:ALL) ALL

  4. (Opcional) Para ejecutar funciones Lambda en contenedores, debe habilitar cgroups v1 y debe habilitar y montar los cgroups de memoria y dispositivos. Si no planea ejecutar funciones Lambda en contenedores, puede omitir este paso.

    Para habilitar estas opciones de cgroups, arranque el dispositivo con los siguientes parámetros del núcleo de Linux.

    cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

    Para obtener información sobre cómo ver y configurar los parámetros del núcleo de su dispositivo, consulte la documentación del sistema operativo y del gestor de arranque. Siga las instrucciones para configurar permanentemente los parámetros del núcleo.

  5. Instale todas las demás dependencias necesarias en su dispositivo tal y como se indica en Requisitos de los dispositivos la lista de requisitos de.

Para configurar un dispositivo Windows para AWS IoT Greengrass V2

  1. Instale el motor de ejecución de Java, que el software AWS IoT Greengrass principal necesita para ejecutarse. Le recomendamos que utilice las versiones de soporte a largo plazo de Amazon Corretto u OpenJDK. Se requiere la versión 8 o superior.

  2. Compruebe si Java está disponible en la variable de sistema PATH y agréguelo si no lo está. La LocalSystem cuenta ejecuta el software AWS IoT Greengrass principal, por lo que debe agregar Java a la variable de sistema PATH en lugar de a la variable de usuario PATH de su usuario. Haga lo siguiente:

    1. Pulse la tecla Windows para abrir el menú de inicio.

    2. Escriba environment variables para buscar las opciones del sistema en el menú de inicio.

    3. En los resultados de la búsqueda del menú de inicio, seleccione Editar las variables de entorno del sistema para abrir la ventana de propiedades del sistema.

    4. Seleccione Variables de entorno... para abrir la ventana Variables de entorno.

    5. En Variables de sistema, seleccione Ruta y, a continuación, elija Editar. En la ventana Editar variables de entorno, puede ver cada ruta en una línea independiente.

    6. Compruebe si la ruta a la bin carpeta de la instalación de Java está presente. La ruta puede tener un aspecto similar al del siguiente ejemplo.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

    7. Si la bin carpeta de la instalación de Java no aparece en Path, seleccione Nueva para añadirla y, a continuación, pulse Aceptar.

  3. Abre la línea de comandos de Windows (cmd.exe) como administrador.

  4. Cree el usuario predeterminado en la LocalSystem cuenta del dispositivo Windows. Sustituya la contraseña por una contraseña segura.

    net user /add ggc_user password
    sugerencia

    Según la configuración de Windows, es posible que la contraseña del usuario caduque en una fecha futura. Para garantizar que sus aplicaciones de Greengrass sigan funcionando, controle cuándo caduque la contraseña y actualícela antes de que caduque. También puede configurar la contraseña del usuario para que nunca caduque.

    • Para comprobar cuándo caducan un usuario y su contraseña, ejecuta el siguiente comando.

      net user ggc_user | findstr /C:expires

    • Para configurar la contraseña de un usuario para que no caduque nunca, ejecute el siguiente comando.

      wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

    • Si utilizas Windows 10 o una versión posterior, donde el wmiccomando está obsoleto, ejecuta el siguiente PowerShell comando.

      Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

  5. Descargue e instale la PsExecutilidad de Microsoft en el dispositivo.

  6. Utilice la PsExec utilidad para almacenar el nombre de usuario y la contraseña del usuario predeterminado en la instancia de Credential Manager de la LocalSystem cuenta. Sustituya la contraseña por la contraseña del usuario que configuró anteriormente.

    psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

    Si se PsExec License Agreementabre, Acceptacepte la licencia y ejecute el comando.

    nota

    En los dispositivos Windows, la LocalSystem cuenta ejecuta el núcleo de Greengrass y debe usar la PsExec utilidad para almacenar la información de usuario predeterminada en la LocalSystem cuenta. El uso de la aplicación Credential Manager almacena esta información en la cuenta de Windows del usuario que ha iniciado sesión actualmente, en lugar de en la LocalSystem cuenta.