Greengrass CLI - AWS IoT Greengrass
VersionesTipoSistema operativoRequisitosDependenciasConfiguraciónArchivo de registro localRegistros de cambios

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.

Greengrass CLI

El CLI componente Greengrass (aws.greengrass.Cli) proporciona una interfaz de línea de comandos local que puede usar en los dispositivos principales para desarrollar y depurar componentes localmente. Greengrass CLI le permite crear despliegues locales y reiniciar componentes en el dispositivo principal, por ejemplo.

Puede instalar este componente al instalar el software AWS IoT Greengrass Core. Para obtener más información, consulte Tutorial: Introducción a AWS IoT Greengrass V2.

importante

Se recomienda utilizar este componente únicamente en entornos de desarrollo, no en entornos de producción. Este componente proporciona acceso a información y operaciones que normalmente no necesitará en un entorno de producción. Siga el principio de privilegios mínimos implementando este componente solo en los dispositivos principales donde lo necesite.

Tras instalar este componente, ejecute el siguiente comando para ver su documentación de ayuda. Cuando se instala este componente, añade un enlace simbólico a greengrass-cli la /greengrass/v2/bin carpeta. Puede ejecutar Greengrass CLI desde esta ruta o añadirlo a su variable de PATH entorno para que se ejecute greengrass-cli sin su ruta absoluta.

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

El siguiente comando reinicia un componente denominadocom.example.HelloWorld, por ejemplo.

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

Para obtener más información, consulte Interfaz de línea de comandos Greengrass.

Versiones

Este componente tiene las siguientes versiones:

  • 2.13.x

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Este componente es un componente de complemento ()aws.greengrass.plugin. El núcleo de Greengrass ejecuta este componente en la misma máquina virtual Java (JVM) que el núcleo. El núcleo se reinicia al cambiar la versión de este componente en el dispositivo principal.

Este componente utiliza el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte Supervisar AWS IoT Greengrass registros.

Para obtener más información, consulte Tipos de componentes.

Sistema operativo

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:

  • Linux

  • Windows

Requisitos

Este componente tiene los siguientes requisitos:

  • 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 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 CLIcomponentes de Greengrass.

  • El CLI componente Greengrass es compatible para ejecutarse en un. VPC

Dependencias

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementarlo correctamente. En esta sección se enumeran las dependencias de las versiones publicadas de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la consola.AWS IoT Greengrass En la página de detalles del componente, busque la lista de dependencias.

2.13.0

En la siguiente tabla se enumeran las dependencias de las versiones 2.12.0 a 2.14.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.12.0 <2.14.0 Flexible
2.12.0 – 2.12.6

En la siguiente tabla se enumeran las dependencias de las versiones 2.12.0 a 2.12.6 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.12.0 <2.13.0 Flexible
2.11.0 – 2.11.3

La siguiente tabla muestra las dependencias de las versiones 2.11.0 a 2.11.3 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.11.0 <2.12.0 Flexible
2.10.0 – 2.10.3

La siguiente tabla muestra las dependencias de las versiones 2.10.0 a 2.10.3 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.5.0 <2.11.0 Flexible
2.9.0 – 2.9.6

La siguiente tabla muestra las dependencias de las versiones 2.9.0 a 2.9.6 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.5.0 <2.10.0 Flexible
2.8.0 – 2.8.1

La siguiente tabla muestra las dependencias de las versiones 2.8.0 y 2.8.1 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.5.0 <2.9.0 Flexible
2.7.0

La siguiente tabla muestra las dependencias de la versión 2.7.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.5.0 <2.8.0 Flexible
2.6.0

La siguiente tabla muestra las dependencias de la versión 2.6.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.5.0 <2.7.0 Flexible
2.5.0 – 2.5.6

La siguiente tabla muestra las dependencias de las versiones 2.5.0 a 2.5.6 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.5.0 <2.6.0 Flexible
2.4.0

La siguiente tabla muestra las dependencias de la versión 2.4.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.5.0 Flexible
2.3.0

La siguiente tabla muestra las dependencias de la versión 2.3.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.4.0 Flexible
2.2.0

La siguiente tabla muestra las dependencias de la versión 2.2.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.3.0 Flexible
2.1.0

La siguiente tabla muestra las dependencias de la versión 2.1.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.1.0 <2.2.0 Flexible
2.0.x

La siguiente tabla muestra las dependencias de la versión 2.0.x de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.1.0 Flexible
nota

La versión mínima compatible del núcleo de Greengrass corresponde a la versión de parche del componente Greengrass. CLI

Para obtener más información sobre las dependencias de los componentes, consulte la referencia de recetas de componentes.

Configuración

Este componente proporciona los siguientes parámetros de configuración que puede personalizar al implementar el componente.

2.5.x - 2.12.x
AuthorizedPosixGroups

(Opcional) Cadena que contiene una lista de grupos de sistemas 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.

AuthorizedWindowsGroups

(Opcional) Cadena que contiene una lista de grupos de sistemas 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.

ejemplo Ejemplo: actualización de combinación de configuraciones

El siguiente ejemplo de configuración especifica que se debe autorizar a tres grupos de POSIX sistemas (group11002, ygroup3) y dos grupos de usuarios de Windows (Device OperatorsyQA Engineers) a usar GreengrassCLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
2.4.x - 2.0.x
AuthorizedPosixGroups

(Opcional) Cadena que contiene una lista de grupos de sistemas 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.

ejemplo Ejemplo: actualización de combinación de configuraciones

El siguiente ejemplo de configuración especifica que se autorice a tres grupos de sistemas (group11002, ygroup3) a usar GreengrassCLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3"
}

Archivo de registro local

Este componente utiliza el mismo archivo de registro que el componente núcleo de Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver los registros de este componente

  • Ejecute el siguiente comando en el dispositivo principal para ver el archivo de registro de este componente en tiempo real. Sustituya /greengrass/v2 o C:\greengrass\v2 con la ruta a la carpeta AWS IoT Greengrass raíz.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Registros de cambios

En la siguiente tabla se describen los cambios en cada versión del componente.

Versión

Cambios

2.13.0

Versión actualizada para el lanzamiento de la versión 2.13.0 de Greengrass nucleus.

2.12.6

Versión actualizada para la versión 2.12.6 de Greengrass Nucleus.

2.12.5

Versión actualizada para el lanzamiento de la versión 2.12.5 de Greengrass nucleus.

2.12.4

Versión actualizada para el lanzamiento de la versión 2.12.4 de Greengrass Nucleus.

2.12.3
aviso

Esta versión ya no está disponible. Las mejoras de esta versión están disponibles en versiones posteriores de este componente.

Versión actualizada para la versión 2.12.3 de Greengrass Nucleus.

2.12.2

Versión actualizada para la versión 2.12.2 de Greengrass Nucleus.

2.12.1

Versión actualizada para la versión 2.12.1 de Greengrass Nucleus.

2.12.0

Versión actualizada para la versión 2.12.0 de Greengrass Nucleus.

2.11.3

Versión actualizada para la versión 2.11.3 de Greengrass Nucleus.

2.11.2

Versión actualizada para el lanzamiento de la versión 2.11.2 de Greengrass nucleus.

2.11.1

Versión actualizada para la versión 2.11.1 de Greengrass Nucleus.

2.11.0
Nuevas características

  • Permite cancelar una implementación local.

  • Le permite configurar una política de gestión de errores para una implementación local.

  • Mejora los informes detallados del estado de la implementación.

2.10.3

Versión actualizada para el lanzamiento de la versión 2.10.3 de Greengrass nucleus.

2.10.2

Versión actualizada para el lanzamiento de la versión 2.10.2 de Greengrass nucleus.

2.10.1

Versión actualizada para el lanzamiento de la versión 2.10.1 de Greengrass nucleus.

2.10.0

Versión actualizada para el lanzamiento de la versión 2.10.0 de Greengrass nucleus.

2.9.6

Versión actualizada para el lanzamiento de la versión 2.9.6 de Greengrass nucleus.

2.9.5

Versión actualizada para el lanzamiento de la versión 2.9.5 de Greengrass nucleus.

2.9.4

Versión actualizada para el lanzamiento de la versión 2.9.4 de Greengrass nucleus.

2.9.3

Versión actualizada para la versión 2.9.3 de Greengrass nucleus.

2.9.2

Versión actualizada para el lanzamiento de la versión 2.9.2 de Greengrass nucleus.

2.9.1

Versión actualizada para la versión 2.9.1 de Greengrass nucleus.

2.9.0

 Versión actualizada para la versión 2.9.0 de Greengrass nucleus.

2.8.1

Versión actualizada para la versión 2.8.1 de Greengrass nucleus.

2.8.0

 Versión actualizada para la versión 2.8.0 de Greengrass nucleus.

2.7.0

Versión actualizada para el lanzamiento de la versión 2.7.0 de Greengrass Nucleus.

2.6.0
Nuevas características

  • Añade compatibilidad con componentes personalizados para llamar a las operaciones de comunicación entre procesos (IPC) que utiliza CLI Greengrass. Puede usar estas IPC operaciones para administrar las implementaciones locales, ver los detalles de los componentes y generar una contraseña que pueda usar para iniciar sesión en la consola de depuración local. Para obtener más información, consulte IPC: Administrar las implementaciones y los componentes locales.

Mejoras y correcciones de errores

  • Correcciones y mejoras menores adicionales.

2.5.6

Versión actualizada para el lanzamiento de la versión 2.5.6 de Greengrass Nucleus.

2.5.5

Versión actualizada para el lanzamiento de la versión 2.5.5 de Greengrass nucleus.

2.5.4

Versión actualizada para el lanzamiento de la versión 2.5.4 del núcleo de Greengrass.

2.5.3

Versión actualizada para el lanzamiento de la versión 2.5.3 de Greengrass nucleus.

2.5.2

Versión actualizada para el lanzamiento de la versión 2.5.2 de Greengrass Nucleus.

2.5.1

Versión actualizada para el lanzamiento de la versión 2.5.1 de Greengrass Nucleus.

2.5.0
Nuevas características

  • Añade compatibilidad con los dispositivos principales que ejecutan Windows.

  • Agrega el nuevo parámetro de AuthorizedWindowsGroups configuración que puede especificar para autorizar a los grupos del sistema a usar Greengrass CLI en dispositivos Windows.

  • Añade el windowsUser parámetro para las implementaciones locales. Puede usar este parámetro para especificar el usuario que se utilizará para ejecutar los componentes en un dispositivo principal de Windows.

2.4.0
Nuevas características

2.3.0

Versión actualizada para el lanzamiento de la versión 2.3.0 de Greengrass nucleus.

2.2.0

Versión actualizada para el lanzamiento de la versión 2.2.0 de Greengrass nucleus.

2.1.0

Versión actualizada para el lanzamiento de la versión 2.1.0 de Greengrass nucleus.

2.0.5

 Versión actualizada para el lanzamiento de la versión 2.0.5 de Greengrass nucleus.

2.0.4

 Versión actualizada para el lanzamiento de la versión 2.0.4 de Greengrass nucleus.

2.0.3

Versión inicial.