Instalación del software AWS IoT Greengrass Core (CLI) - AWS IoT Greengrass

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

Instalación y configuración del software AWS IoT Greengrass Core

  1. En su dispositivo principal de Greengrass, ejecute el siguiente comando para cambiar al directorio de inicio.

    Linux or Unix
    cd ~
    Windows Command Prompt (CMD)
    cd %USERPROFILE%
    PowerShell
    cd ~

  2. En su dispositivo principal, descargue el software AWS IoT Greengrass Core a un archivo denominado greengrass-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.

  3. Descomprima el software AWS IoT Greengrass Core a una carpeta de su dispositivo. Reemplace GreengrassInstaller 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. Ejecute el siguiente comando para iniciar el instalador del software AWS IoT Greengrass Core. Este comando hace lo siguiente:

    • Cree los recursos de AWS que el dispositivo principal necesita para funcionar.

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

    Reemplace los valores de los argumentos en su comando de la siguiente manera.

    1. /greengrass/v2 o C:\greengrass\v2: la ruta a la carpeta raíz que se usa para instalar el software AWS IoT Greengrass Core.

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

    3. region. La Región de AWS en la que se van a buscar o crear recursos.

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

      nota

      El nombre del objeto no puede contener dos puntos (:).

    5. MyGreengrassCoreGroup. El nombre del grupo de objetos AWS IoT para su dispositivo principal de Greengrass. Si el grupo de objetos no existe, el instalador lo crea y le agrega un objeto. Si el grupo de objetos 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 objetos no puede contener dos puntos (:).

    6. GreengrassV2IoTThingPolicy. El nombre de la política de AWS IoT que permite a los dispositivos principales de Greengrass comunicarse con AWS IoT y AWS IoT Greengrass. Si la política de AWS IoT no existe, el instalador crea una política de AWS IoT 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 Política mínima de AWS IoT para dispositivos principales de AWS IoT Greengrass V2.

    7. GreengrassV2TokenExchangeRole. El nombre del rol de IAM que permite al dispositivo principal de Greengrass obtener credenciales de AWS temporales. Si el rol no existe, el instalador lo crea y asocia una política denominada GreengrassV2TokenExchangeRoleAccess. Para obtener más información, consulte Autorización de los dispositivos principales para interactuar con los servicios de AWS.

    8. GreengrassCoreTokenExchangeRoleAlias. El alias del rol 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 Autorización de los dispositivos principales para interactuar con los servicios de AWS.

    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 \
  --deploy-dev-tools 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 ^
  --deploy-dev-tools 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 `
  --deploy-dev-tools true
    nota

    Si ejecuta AWS IoT Greengrass en un dispositivo con memoria limitada, puede controlar la cantidad de memoria que usa el software AWS IoT Greengrass Core. Para controlar la asignación de memoria, puede configurar las opciones de tamaño de montón de la JVM en el parámetro de configuración jvmOptions del componente núcleo. Para obtener más información, consulte Control de la asignación de memoria con las opciones de JVM.

    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.