Instalación del software AWS IoT Greengrass Core (consola) - 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.

Instalación del software AWS IoT Greengrass Core (consola)

  1. Inicie sesión en la consola de AWS IoT Greengrass.

  2. En Get started with Greengrass (Comenzar con Greengrass), seleccione Set up core device (Configurar un dispositivo principal).

  3. En el Paso 1: Registrar un dispositivo principal de Greengrass, en Nombre del dispositivo principal, introduzca el nombre del objeto AWS IoT para su dispositivo principal de Greengrass. Si el objeto no existe, el instalador la crea.

  4. En el Paso 2: Agregar a un grupo de objetos para aplicar una implementación continua, en Grupo de objetos, elija el grupo de objetos AWS IoT al que quiere agregar su dispositivo principal.

    • Si selecciona Introducir un nombre de grupo nuevo, a continuación, en Nombre de grupo de objetos, introduzca el nombre del nuevo grupo que desee crear. El instalador crea el nuevo grupo automáticamente.

    • Si selecciona Seleccionar un grupo existente, luego en Nombre del grupo de objetos, elija el grupo existente que desee usar.

    • Si selecciona Sin grupo, el instalador no agregará el dispositivo principal a un grupo de objetos.

  5. En el Paso 3: Instalar el software Greengrass Core, complete los siguientes pasos.

    Nucleus classic

    1. Seleccione Nucleus classic (versión clásica del núcleo) como el tiempo de ejecución del software de su dispositivo principal.

    2. Elija el sistema operativo de su dispositivo principal: Linux o Windows.

    3. Proporcione sus credenciales de AWS al dispositivo para que el instalador pueda aprovisionar los recursos de AWS IoT y de IAM para 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 sus 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 Core:

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

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

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

          Linux or UnixWindows Command Prompt (CMD)PowerShell
          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="

      • Use credenciales de seguridad temporales de un rol de (IAM):

        1. Proporcione el ID de clave de acceso, la clave de acceso secreta y el token de sesión desde un rol de IAM que asuma. Para obtener más información acerca de 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 Core.

          Linux or UnixWindows Command Prompt (CMD)PowerShell
          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="

      • Use credenciales a largo plazo de un usuario de IAM:

        1. Proporcione el ID de clave de acceso y la clave de acceso secreta del usuario de IAM. Puede crear un usuario de IAM para el aprovisionamiento y luego eliminarlo. Para 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 información acerca de cómo recuperar credenciales a largo plazo, consulte Administración de las claves de acceso de los usuarios de IAM en la Guía de usuario de IAM.

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

          Linux or UnixWindows Command Prompt (CMD)PowerShell
          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 de 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 claves de acceso en la Guía de usuario de AWS Identity and Access Management.

    4. En Ejecutar el instalador, complete los pasos siguientes.

      1. En Descargar el instalador, seleccione Copiar y ejecute el comando copiado en su dispositivo principal. Este comando descarga la última versión del software AWS IoT Greengrass Core y la descomprime en el dispositivo.

      2. En Ejecutar el instalador, seleccione Copiar y ejecute el comando copiado en su dispositivo principal. Este comando usa los nombres de objetos AWS IoT y grupos de objetos que especificó anteriormente para ejecutar el instalador del software AWS IoT Greengrass Core y configurar los recursos de AWS del dispositivo principal.

        Este comando también hace lo siguiente:

        • Configure el software AWS IoT Greengrass Core como un servicio del sistema que se ejecute durante el arranque. En los dispositivos Linux, esto requiere el sistema de inicio Systemd.

          importante

          En los dispositivos principales de Windows, debe configurar el software AWS IoT Greengrass Core como un servicio del sistema.

        • Implemente el componente de la CLI de AWS IoT Greengrass, que es una herramienta de línea de comandos que le permite desarrollar componentes personalizados de Greengrass en el dispositivo principal.

        • Especifique si desea usar el usuario del sistema ggc_user para ejecutar los componentes de software en el dispositivo principal. En los dispositivos Linux, este comando también especifica el uso del grupo del sistema ggc_group y el instalador crea el usuario y el grupo del sistema por usted.

        Al ejecutar este comando, deberían aparecer los siguientes mensajes para indicar que el instalador se ha realizado correctamente.

        Successfully configured Nucleus with provisioned resource details!
Configured Nucleus to deploy aws.greengrass.Cli component
Successfully set up Nucleus as a system service
        nota

        Si tiene un dispositivo Linux y este no tiene systemd, el instalador no configurará el software como un servicio del sistema y no verá el mensaje de éxito al configurar el núcleo como un servicio del sistema.

    Nucleus lite

    1. Seleccione Nucleus lite (versión lite del núcleo) como el tiempo de ejecución del software de su dispositivo principal.

    2. Seleccione el método de configuración de su dispositivo para aprovisionar su dispositivo a un dispositivo principal de Greengrass.

    Opción 1: configure un dispositivo con la descarga del paquete (aproximadamente 1 MB)

    1. Cree un objeto de AWS IoT y el rol de Greengrass.

    2. Descargue el archivo zip que contiene los recursos de AWS IoT a los que su dispositivo necesita conectarse a AWS IoT:

      • Un certificado y una clave privada generados mediante la autoridad de certificación de AWS IoT.

      • Un archivo de esquema para iniciar la instalación de Greengrass en su dispositivo.

    3. Descargue el paquete que instalará el tiempo de ejecución más reciente de la versión lite del núcleo de Greengrass en su Raspberry Pi.

    4. Aprovisione su dispositivo para que se convierta en un dispositivo de AWS IoT Greengrass Core y conéctelo a AWS IoT:

      1. a. Transfiera el paquete Greengrass y el kit de conexión a su dispositivo mediante una memoria USB, SCP/FTP o tarjetas SD.

      2. b. Descomprima el archivo greengrass-package.zip en el directorio /GreengrassInstaller del dispositivo.

      3. c. Descomprima el archivo zip del kit de conexión en el /directorio del dispositivo.

      4. d. Ejecute el comando proporcionado en el dispositivo para instalar AWS IoT Greengrass

    5. A continuación, seleccione Ver dispositivos principales.

    Opción 2: configure un dispositivo con una descarga de imagen de muestra de disco completo preconfigurada (aproximadamente 100 MB)

    1. Cree un objeto de AWS IoT y el rol de Greengrass.

    2. Descargue el archivo zip que contiene los recursos de AWS IoT a los que su dispositivo necesita conectarse a AWS IoT:

      • Un certificado y una clave privada generados mediante la autoridad de certificación de AWS IoT.

      • Un archivo de esquema para iniciar la instalación de Greengrass en su dispositivo.

    3. Descargue la imagen de muestra de disco completo preconfigurada que contiene Greengrass y el sistema operativo.

      1. Para transferir el kit de conexión y mostrar la imagen en su dispositivo, siga el archivo readme que se descargó con la imagen.

      2. Para iniciar la instalación de Greengrass, encienda y arranque el dispositivo desde la imagen mostrada

    4. A continuación, seleccione Ver dispositivos principales.

    Opción 3: configure un dispositivo con su propia versión personalizada

    1. Cree un objeto de AWS IoT y el rol de Greengrass.

    2. Descargue el archivo zip que contiene los recursos de AWS IoT a los que su dispositivo necesita conectarse a AWS IoT:

      • Un certificado y una clave privada generados mediante la autoridad de certificación de AWS IoT.

      • Un archivo de esquema para iniciar la instalación de Greengrass en su dispositivo.

    3. Para personalizar y crear su propia imagen con Yocto a partir del código origen y luego usar el kit de conexión para instalar la versión lite del núcleo, siga las instrucciones de GitHub.

      1. A continuación, seleccione Ver dispositivos principales.