Instalación del software AWS IoT Greengrass principal (CLI) - 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 principal (CLI)

Para instalar y configurar el software AWS IoT Greengrass principal

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

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

  3. Descomprime el software AWS IoT Greengrass Core 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. Ejecute el siguiente comando para iniciar el instalador del software AWS IoT Greengrass Core. Este comando hace lo siguiente:

    • Cree los AWS recursos 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 AWS IoT Greengrass CLI, que es una herramienta de línea de comandos que le permite desarrollar componentes personalizados de Greengrass en el dispositivo principal.

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

    Sustituya los valores de los argumentos en el 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 \
  --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 utiliza un AWS IoT Greengrass dispositivo con memoria limitada, puede controlar la cantidad de memoria que utiliza el software AWS IoT Greengrass Core. Para controlar la asignación de memoria, puede configurar las opciones de tamaño de pila de la JVM en el parámetro de jvmOptions configuración del componente core. Para obtener más información, consulte Controle 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.