Instalación de la CLI de Greengrass - AWS IoT Greengrass
Requisitos previosImplemente el componente CLI de 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 de la CLI de Greengrass

Puede instalar la CLI de Greengrass de una 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 la aplicación de este argumento.

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

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

Requisitos previos

Para implementar el componente CLI de 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: Introducción a AWS IoT Greengrass V2.

  • Para utilizar el AWS CLI para implementar la CLI de Greengrass, 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 la CLI de Greengrass para interactuar con el software AWS IoT Greengrass principal. Realice una de las siguientes acciones para usar la CLI de Greengrass:

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

    • Utilice un usuario con permisos root o administrativos. En los dispositivos principales de Linux, puede utilizarlos sudo para obtener permisos de root.

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

Implemente el componente CLI de Greengrass

Complete los siguientes pasos para implementar el componente CLI de 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.Cli, elija Implementar.

  5. En Añadir a la implementación, elija Crear nueva implementación.

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

  7. En la página Seleccionar componentes, compruebe que el aws.greengrass.Clicomponente esté seleccionado y elija Siguiente.

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

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

  10. En la página de revisión, haga clic en Implementar

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

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

    • En el campo target, sustituya targetArn por el nombre de 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 aws.greengrass.Cli componente, especifique los valores de la siguiente manera:

      version

      La versión del componente CLI de Greengrass.

      configurationUpdate.AuthorizedPosixGroups

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

      Si no especifica ningún grupo para autorizarlo, puede usar la CLI de Greengrass como administrador o como usuario del sistema que ejecuta el software AWS IoT Greengrass principal.

  2. Ejecute el siguiente comando para implementar el componente CLI de 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 usted ejecuta la CLI de Greengrass desde esta ruta. Para ejecutar la CLI de Greengrass sin su ruta absoluta, añada la /greengrass/v2/bin carpeta a la variable PATH. Para comprobar la instalación de la CLI 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 la CLI de Greengrass. Para obtener más información, consulte Solución de problemas AWS IoT Greengrass V2.