Instale el software AWS IoT Greengrass principal con aprovisionamiento automático de recursos

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 le 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 kernel 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.

Para proporcionar AWS credenciales al dispositivo

• Proporcione sus AWS credenciales al dispositivo para que el instalador pueda aprovisionar los recursos de IAM AWS IoT y los de su dispositivo principal. Para aumentar la seguridad, le recomendamos que obtenga credenciales temporales para un rol de IAM que permita únicamente los permisos mínimos necesarios para el aprovisionamiento. Para obtener más información, consulte Política de IAM mínima para que el instalador aprovisione recursos.

  nota

  El instalador no guarda ni almacena tus credenciales.

  En el dispositivo, realice una de las siguientes acciones para recuperar las credenciales y ponerlas a disposición del instalador del software AWS IoT Greengrass principal:

  • (Recomendado) Utilice credenciales temporales de AWS IAM Identity Center

    1. Proporcione el ID de la clave de acceso, la clave de acceso secreta y el token de sesión del Centro de identidades de IAM. Para obtener más información, consulte Actualización manual de credenciales en Obtener y actualizar credenciales temporales en la guía del usuario del IAM Identity Center.

    2. Ejecute los siguientes comandos para proporcionar las credenciales al software AWS IoT Greengrass principal.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

  • Utilice credenciales de seguridad temporales de un rol de IAM:

    1. Proporcione el ID de la clave de acceso, la clave de acceso secreta y el token de sesión de la función de IAM que asuma. Para obtener más información sobre cómo recuperar estas credenciales, consulte Solicitud de credenciales de seguridad temporales en la Guía del usuario de IAM.

    2. Ejecute los siguientes comandos para proporcionar las credenciales al software AWS IoT Greengrass principal.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

  • Utilice credenciales de larga duración de un usuario de IAM:

    1. Proporcione el ID de la clave de acceso y la clave de acceso secreta de su usuario de IAM. Puede crear un usuario de IAM para el aprovisionamiento y eliminarlo más adelante. Para obtener información sobre la política de IAM que debe proporcionarse al usuario, consulte. Política de IAM mínima para que el instalador aprovisione recursos Para obtener más información sobre cómo recuperar credenciales de larga duración, consulte Administrar las claves de acceso para los usuarios de IAM en la Guía del usuario de IAM.

    2. Ejecute los siguientes comandos para proporcionar las credenciales al software AWS IoT Greengrass principal.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

    3. (Opcional) Si creó un usuario de IAM para aprovisionar su dispositivo Greengrass, elimínelo.

    4. (Opcional) Si utilizó el ID de clave de acceso y la clave de acceso secreta de un usuario de IAM existente, actualice las claves del usuario para que dejen de ser válidas. Para obtener más información, consulte Actualización de las claves de acceso en la guía del AWS Identity and Access Management usuario.

Para descargar el software AWS IoT Greengrass principal

1. En su dispositivo principal, descargue el software AWS IoT Greengrass Core en un archivo denominadogreengrass-nucleus-latest.zip.

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   Al descargar este software, acepta el acuerdo de licencia del software de Greengrass Core.

2. (Opcional) Para verificar la firma del software Greengrass Nucleus

   nota

   Esta función está disponible con la versión 2.9.5 y posteriores del núcleo de Greengrass.

   1. Usa el siguiente comando para verificar la firma del artefacto núcleo de Greengrass:

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      El nombre del archivo puede tener un aspecto diferente según la versión de JDK que instale. jdk17.0.6_10Sustitúyalo por la versión de JDK que instaló.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      El nombre del archivo puede tener un aspecto diferente en función de la versión de JDK que instale. jdk17.0.6_10Sustitúyalo por la versión de JDK que instaló.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

   2. La jarsigner invocación produce un resultado que indica los resultados de la verificación.

      1. Si el archivo zip del núcleo de Greengrass está firmado, el resultado contiene la siguiente declaración:

         jar verified.

      2. Si el archivo zip del núcleo de Greengrass no está firmado, el resultado contiene la siguiente declaración:

         jar is unsigned.

   3. Si ha proporcionado la -certs opción Jarsigner junto con -verbose las opciones -verify y, el resultado también incluye información detallada del certificado de firmante.

3. Descomprime el software AWS IoT Greengrass principal en una carpeta de tu dispositivo. GreengrassInstallerSustitúyalo por la carpeta que desee usar.

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

4. (Opcional) Ejecute el siguiente comando para ver la versión del software AWS IoT Greengrass principal.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Para instalar el software de AWS IoT Greengrass Core

1. Ejecute el instalador AWS IoT Greengrass Core. Reemplace los valores de los argumentos en su comando de la siguiente manera.

   1. /greengrass/v2o C:\greengrass\v2: la ruta a la carpeta raíz que se utilizará para instalar el software AWS IoT Greengrass principal.

   2. GreengrassInstaller. La ruta a la carpeta en la que desempaquetó el instalador del software AWS IoT Greengrass Core.

   3. region. Región de AWSEn la que se buscan o crean los recursos.

   4. MyGreengrassCore. El nombre del AWS IoT dispositivo principal de Greengrass. Si la cosa no existe, el instalador la crea. El instalador descarga los certificados para autenticarse como talAWS IoT. Para obtener más información, consulte Autenticación y autorización de dispositivos en AWS IoT Greengrass.

      nota

      El nombre de la cosa no puede contener dos puntos (:).

   5. MyGreengrassCoreGroup. El nombre del grupo de AWS IoT cosas de su dispositivo principal de Greengrass. Si el grupo de cosas no existe, el instalador lo crea y lo añade. Si el grupo de cosas existe y tiene una implementación activa, el dispositivo principal descarga y ejecuta el software que especifique la implementación.

      nota

      El nombre del grupo de cosas no puede contener dos puntos (:).

   6. Greengrass V2 IoT ThingPolicy. El nombre de la AWS IoT política que permite a los dispositivos principales de Greengrass comunicarse con AWS IoT y. AWS IoT Greengrass Si la AWS IoT política no existe, el instalador crea una AWS IoT política permisiva con este nombre. Puede restringir los permisos de esta política según su caso de uso. Para obtener más información, consulte AWS IoTPolítica mínima para los dispositivos AWS IoT Greengrass V2 principales.

   7. Greengrass V2 TokenExchangeRole. El nombre de la función de IAM que permite al dispositivo principal de Greengrass obtener AWS credenciales temporales. Si la función no existe, el instalador la crea y adjunta una política denominada. GreengrassV2TokenExchangeRoleAccess Para obtener más información, consulte Autorizar a los dispositivos principales a interactuar con AWS los servicios.

   8. GreengrassCoreTokenExchangeRoleAlias. El alias de la función de IAM que permite al dispositivo principal de Greengrass obtener credenciales temporales más adelante. Si el alias del rol no existe, el instalador lo crea y lo dirige al rol de IAM que especifique. Para obtener más información, consulte Autorizar a los dispositivos principales a interactuar con AWS los servicios.

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --thing-policy-name GreengrassV2IoTThingPolicy \
     --tes-role-name GreengrassV2TokenExchangeRole \
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --aws-region region ^
     --thing-name MyGreengrassCore ^
     --thing-group-name MyGreengrassCoreGroup ^
     --thing-policy-name GreengrassV2IoTThingPolicy ^
     --tes-role-name GreengrassV2TokenExchangeRole ^
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
     --component-default-user ggc_user ^
     --provision true ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --aws-region region `
     --thing-name MyGreengrassCore `
     --thing-group-name MyGreengrassCoreGroup `
     --thing-policy-name GreengrassV2IoTThingPolicy `
     --tes-role-name GreengrassV2TokenExchangeRole `
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
     --component-default-user ggc_user `
     --provision true `
     --setup-system-service true

   importante

   En los dispositivos principales de Windows, debe especificar si --setup-system-service true desea configurar el software AWS IoT Greengrass principal como un servicio del sistema.

   Si lo consigue, el instalador imprime los siguientes mensajes:

   • Si lo especifica--provision, el instalador Successfully configured Nucleus with provisioned resource details imprimirá si configuró los recursos correctamente.

   • Si lo especifica--deploy-dev-tools, el instalador imprimirá Configured Nucleus to deploy aws.greengrass.Cli component si creó la implementación correctamente.

   • Si lo especifica--setup-system-service true, el instalador imprimirá Successfully set up Nucleus as a system service si configuró y ejecutó el software como un servicio.

   • Si no lo especifica--setup-system-service true, el instalador imprimirá Launched Nucleus successfully si se ejecutó correctamente y ejecutó el software.

2. Omita este paso si instaló la Núcleo de Greengrass versión 2.0.4 o una versión posterior. Si descargó la última versión del software, instaló la versión 2.0.4 o posterior.

   Ejecute el siguiente comando para configurar los permisos de archivo necesarios para la carpeta raíz AWS IoT Greengrass del software principal. /greengrass/v2Sustitúyala por la carpeta raíz que especificó en el comando de instalación y sustituya /greengrass por la carpeta principal de la carpeta raíz.

   sudo chmod 755 /greengrass/v2 && sudo chmod 755 /greengrass