Instala el Greengrass CLI - AWS IoT Greengrass
Requisitos previosImplemente el componente Greengrass CLI

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.

Instala el Greengrass CLI

Puede instalar el Greengrass de una CLI de las siguientes maneras:

  • Utilice --deploy-dev-tools este argumento la primera vez que configure el software AWS IoT Greengrass Core en su dispositivo. También debe especificar --provision true si desea aplicar este argumento.

  • Implemente el CLI componente Greengrass (aws.greengrass.Cli) en su dispositivo.

En esta sección se describen los pasos para implementar el componente GreengrassCLI. Para obtener información sobre la instalación de Greengrass CLI durante la configuración inicial, consulte. Tutorial: Cómo empezar con AWS IoT Greengrass V2

Requisitos previos

Para implementar el CLI componente Greengrass, debe cumplir los siguientes requisitos:

  • AWS IoT Greengrass El software principal está instalado y configurado en su dispositivo principal. Para obtener más información, consulte Tutorial: Cómo empezar con AWS IoT Greengrass V2.

  • Para usar el AWS CLI para implementar GreengrassCLI, debe haber instalado y configurado el. AWS CLI Para obtener más información, consulte Configuración de la AWS CLI en la Guía del usuario de AWS Command Line Interface .

  • Debe estar autorizado a utilizar Greengrass CLI para interactuar con el software AWS IoT Greengrass Core. Realice una de las siguientes acciones para usar GreengrassCLI:

    • Utilice el usuario del sistema que ejecuta el software AWS IoT Greengrass Core.

    • Utilice un usuario con permisos raíz o administrativos. En los dispositivos principales de Linux, puede utilizar sudo para obtener permisos de raíz.

    • Utilice un usuario del sistema que esté en un grupo que especifique en los parámetros de configuración AuthorizedPosixGroups o AuthorizedWindowsGroups al implementar el componente. Para obtener más información, consulte Configuración de CLIcomponentes de Greengrass.

Implemente el componente Greengrass CLI

Complete los siguientes pasos para implementar el CLI componente Greengrass en su dispositivo principal:

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

  2. En el menú de navegación, elija Componentes.

  3. En la página Componentes, en la pestaña Componentes públicos, elija aws.greengrass.Cli.

  4. En la página aws.greengrass.CliEn esta página, elija Implementar.

  5. En Agregar a la implementación, elija Crear nueva implementación.

  6. En la página Especificar destino, en Objetivos de implementación, en la lista Nombre de destino, elija el grupo de Greengrass en el que desee realizar la implementación y elija Siguiente.

  7. En la página Seleccionar componentes, compruebe que aws.greengrass.Cliel componente está seleccionado y pulse Siguiente.

  8. En la página Configurar componentes, mantenga los ajustes de configuración predeterminados y seleccione Siguiente.

  9. En la página Configurar ajustes avanzados, mantenga los ajustes de configuración predeterminados y seleccione Siguiente.

  10. En la página Revisar, elija Implementar.

  1. En su dispositivo, cree un deployment.json archivo para definir la configuración de despliegue del componente GreengrassCLI. Este archivo debería tener el siguiente aspecto:

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • En el target campo, targetArn sustitúyalo por el nombre del recurso de Amazon (ARN) de la cosa o grupo de cosas a la que apunte la implementación, en el siguiente formato:

      • Cosa: arn:aws:iot:region:account-id:thing/thingName

      • Grupo de cosas: arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • En el objeto del componente aws.greengrass.Cli, especifique los valores de la siguiente manera:

      version

      La versión del componente GreengrassCLI.

      configurationUpdate.AuthorizedPosixGroups

      (Opcional) Una cadena que contiene una lista de grupos de sistema separados por comas. Usted autoriza a estos grupos de sistemas a utilizar Greengrass CLI para interactuar con el software AWS IoT Greengrass principal. Puede especificar los nombres de los grupos o gruposIDs. Por ejemplo, group1,1002,group3 autoriza a tres grupos de sistemas (group11002, ygroup3) a usar GreengrassCLI.

      Si no especificas ningún grupo para autorizarlo, puedes usar Greengrass CLI como usuario root (sudo) o como usuario del sistema que ejecuta el software AWS IoT Greengrass Core.

      configurationUpdate.AuthorizedWindowsGroups

      (Opcional) Una cadena que contiene una lista de grupos de sistema separados por comas. Usted autoriza a estos grupos de sistemas a utilizar Greengrass CLI para interactuar con el software AWS IoT Greengrass principal. Puede especificar los nombres de los grupos o gruposIDs. Por ejemplo, group1,1002,group3 autoriza a tres grupos de sistemas (group11002, ygroup3) a usar GreengrassCLI.

      Si no especificas ningún grupo para autorizarlo, puedes usar Greengrass CLI como administrador o como usuario del sistema que ejecuta el software AWS IoT Greengrass Core.

  2. Ejecute el siguiente comando para implementar el CLI componente Greengrass en el dispositivo:

    $ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json

Durante la instalación, el componente añade un enlace simbólico a greengrass-cli la /greengrass/v2/bin carpeta del dispositivo y se ejecuta Greengrass CLI desde esta ruta. Para ejecutar Greengrass CLI sin su ruta absoluta, añada su /greengrass/v2/bin carpeta a la variable. PATH Para comprobar la CLI instalación de Greengrass, ejecute el siguiente comando:

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

Debería ver los siguientes datos de salida:

Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
Greengrass command line interface

      --ggcRootPath=<ggcRootPath>
                  The AWS IoT Greengrass V2 root directory.
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.
Commands:
  help                Show help information for a command.
  component           Retrieve component information and stop or restart
                        components.
  deployment          Create local deployments and retrieve deployment status.
  logs                Analyze Greengrass logs.
  get-debug-password  Generate a password for use with the HTTP debug view
                        component.

Si greengrass-cli no lo encuentra, es posible que la implementación no haya podido instalar GreengrassCLI. Para obtener más información, consulte Solución de problemas AWS IoT Greengrass V2.