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.

# CLI de Greengrass
<a name="greengrass-cli-component"></a>

El componente CLI de 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 de forma local. La CLI de Greengrass le permite crear implementaciones locales y reiniciar componentes en el dispositivo principal, por ejemplo.

Puede instalar este componente al instalar el software principal. AWS IoT Greengrass Para obtener más información, consulte [Tutorial: Introducción a AWS IoT Greengrass V2](getting-started.md).

**importante**  
 <a name="local-dev-tools-production-environment-warning"></a>Se recomienda usar este componente solo en entornos de desarrollo y no en entornos de producción. Este componente brinda acceso a información y operaciones que, por lo general, no necesitará en un entorno de producción. Siga el principio de privilegio mínimo al implementar este componente solo en los dispositivos principales donde lo necesite. 

Una vez instalado este componente, ejecute el siguiente comando para ver la documentación de ayuda. Cuando se instala este componente, se agrega un enlace simbólico a `greengrass-cli` en la carpeta `/greengrass/v2/bin`. Puede ejecutar la CLI de Greengrass desde esta ruta o agregarla a la variable de entorno `PATH` para que `greengrass-cli` se ejecute sin la 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 denominado `com.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 la línea de comandos de Greengrass](gg-cli.md).

**Topics**
+ [Versiones](#greengrass-cli-component-versions)
+ [Tipo](#greengrass-cli-component-type)
+ [Sistema operativo](#greengrass-cli-component-os-support)
+ [Requisitos](#greengrass-cli-component-requirements)
+ [Dependencias](#greengrass-cli-component-dependencies)
+ [Configuración](#greengrass-cli-component-configuration)
+ [Archivo de registro local](#greengrass-cli-component-log-file)
+ [Registros de cambios](#greengrass-cli-component-changelog)

## Versiones
<a name="greengrass-cli-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 2.16.x
+ 2.15.x
+ 2.14.x
+ 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
<a name="greengrass-cli-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Este componente es un componente de complemento (`aws.greengrass.plugin`). El [núcleo de Greengrass](greengrass-nucleus-component.md) 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.

<a name="public-component-type-plugin-para2"></a>Este componente usa el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte [Supervisión de los registros de AWS IoT Greengrass](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="greengrass-cli-component-os-support"></a>

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

## Requisitos
<a name="greengrass-cli-component-requirements"></a>

Este componente tiene los siguientes requisitos:
+ <a name="greengrass-cli-authorization-requirement"></a>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 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 del componente de la CLI de Greengrass](#greengrass-cli-component-configuration).
+ Se admite la ejecución del componente CLI de Greengrass en una VPC.

## Dependencias
<a name="greengrass-cli-component-dependencies"></a>

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 implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#greengrass-cli-component-changelog) 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 de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

------
#### [ 2.16.0 ]

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


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.17.0 | Flexible | 

------
#### [ 2.15.1 ]

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


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Flexible | 

------
#### [ 2.15.0 ]

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


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Flexible | 

------
#### [ 2.14.0 – 2.14.3 ]

La siguiente tabla muestra las dependencias de las versiones 2.14.0 y 2.14.3 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.15.0 | Flexible | 

------
#### [ 2.13.0 ]

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


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Flexible | 

------
#### [ 2.12.0 – 2.12.6 ]

En la siguiente tabla, se muestran 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](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Flexible | 

------
#### [ 2.11.0 – 2.11.3 ]

En la siguiente tabla, se muestran 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](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Flexible | 

------
#### [ 2.10.0 – 2.10.3 ]

En la siguiente tabla, se muestran 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](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flexible | 

------
#### [ 2.9.0 – 2.9.6 ]

En la siguiente tabla, se muestran 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](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flexible | 

------
#### [ 2.8.0 – 2.8.1 ]

En la siguiente tabla, se muestran 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](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Flexible | 

------
#### [ 2.7.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.7.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Flexible | 

------
#### [ 2.6.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.6.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Flexible | 

------
#### [ 2.5.0 – 2.5.6 ]

En la siguiente tabla, se muestran 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](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Flexible | 

------
#### [ 2.4.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.4.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Flexible | 

------
#### [ 2.3.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.3.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Flexible | 

------
#### [ 2.2.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.2.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Flexible | 

------
#### [ 2.1.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.1.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Flexible | 

------
#### [ 2.0.x ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.x de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=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 revisión del componente CLI de Greengrass. 

------

Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="greengrass-cli-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

------
#### [ 2.5.x - 2.14.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Opcional) Una cadena que contiene una lista de grupos de sistema 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 de los grupos o grupos IDs. Por ejemplo, `group1,1002,group3` autoriza a tres grupos de sistemas (`group1`, `1002` y `group3`) 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.

`AuthorizedWindowsGroups`  <a name="greengrass-cli-component-configuration-authorizedwindowsgroups"></a>
(Opcional) Una cadena que contiene una lista de grupos de sistema 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 de los grupos o grupos IDs. Por ejemplo, `group1,1002,group3` autoriza a tres grupos de sistemas (`group1`, `1002` y `group3`) 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.

**Example Ejemplo: actualización de la combinación de configuraciones**  
En el siguiente ejemplo de configuración, se especifica que se debe autorizar a tres grupos del sistema POSIX (`group1`, `1002` y `group3`) y dos grupos de usuarios de Windows (`Device Operators` y `QA Engineers`) a utilizar la CLI de Greengrass.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
```

------
#### [ 2.4.x - 2.0.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Opcional) Una cadena que contiene una lista de grupos de sistema 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 de los grupos o grupos IDs. Por ejemplo, `group1,1002,group3` autoriza a tres grupos de sistemas (`group1`, `1002` y `group3`) 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.

**Example Ejemplo: actualización de la combinación de configuraciones**  
En el siguiente ejemplo de configuración, se especifica que se autorice a tres grupos de sistemas (`group1`, `1002` y `group3`) a utilizar la CLI de Greengrass.  

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

------

## Archivo de registro local
<a name="greengrass-cli-component-log-file"></a>

Este componente utiliza el mismo archivo de registro que el componente [núcleo de Greengrass](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Visualización de los registros de este componente**
+ Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. Sustituya `/greengrass/v2` o *C:\$1greengrass\$1v2* por 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
<a name="greengrass-cli-component-changelog"></a>

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


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
|  2.16.1  |  Versión actualizada para la versión 2.16.1 de Greengrass Nucleus.  | 
|  2.16.0  |  Versión actualizada para la versión 2.16.0 de Greengrass nucleus.  | 
|  2.15.1  |  Versión actualizada para la versión 2.15.1 de Greengrass Nucleus.  | 
|  2.15.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.14.3  |  Versión actualizada para la versión 2.14.3 de Greengrass Nucleus.  | 
|  2.14.2  |  Versión actualizada para la versión 2.14.2 de Greengrass Nucleus.  | 
|  2.14.1  |  Versión actualizada para la versión 2.14.1 de Greengrass Nucleus.  | 
|  2.14.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.13.0  |  Versión actualizada para el lanzamiento de la versión 2.13.0 del núcleo de Greengrass.  | 
|  2.12.6  |  Versión actualizada de la versión 2.12.6 del núcleo de Greengrass.  | 
|  2.12.5  |  Versión actualizada para el lanzamiento de la versión 2.12.5 del núcleo de Greengrass.  | 
|  2.12.4  |  Versión actualizada para el lanzamiento de la versión 2.12.4 del núcleo de Greengrass.  | 
|  2.12.3  |   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 el lanzamiento de la versión 2.12.3 del núcleo de Greengrass.  | 
|  2.12.2  |  Versión actualizada para el lanzamiento de la versión 2.12.2 del núcleo de Greengrass.  | 
|  2.12.1  |  Versión actualizada para el lanzamiento de la versión 2.12.1 del núcleo de Greengrass.  | 
|  2.12.0  |  Versión actualizada para el lanzamiento de la versión 2.12.0 del núcleo de Greengrass.  | 
|  2.11.3  |  Versión actualizada para el lanzamiento de la versión 2.11.3 del núcleo de Greengrass.  | 
|  2.11.2  |  Versión actualizada para el lanzamiento de la versión 2.11.2 del núcleo de Greengrass.  | 
|  2.11.1  |  Versión actualizada para el lanzamiento de la versión 2.11.1 del núcleo de Greengrass.  | 
|  2.11.0  |  <a name="changelog-cli-2.11.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.10.3  |  Versión actualizada para el lanzamiento de la versión 2.10.3 del núcleo de Greengrass.  | 
|  2.10.2  |  Versión actualizada para el lanzamiento de la versión 2.10.2 del núcleo de Greengrass.  | 
|  2.10.1  |  Versión actualizada para el lanzamiento de la versión 2.10.1 del núcleo de Greengrass.  | 
|  2.10.0  |  Versión actualizada para el lanzamiento de la versión 2.10.0 del núcleo de Greengrass.  | 
|  2.9.6  |  Versión actualizada para el lanzamiento de la versión 2.9.6 del núcleo de Greengrass.  | 
|  2.9.5  |  Versión actualizada para el lanzamiento de la versión 2.9.5 del núcleo de Greengrass.  | 
|  2.9.4  |  Versión actualizada para el lanzamiento de la versión 2.9.4 del núcleo de Greengrass.  | 
|  2.9.3  |  Versión actualizada para el lanzamiento de la versión 2.9.3 del núcleo de Greengrass.  | 
|  2.9.2  |  Versión actualizada para el lanzamiento de la versión 2.9.2 del núcleo de Greengrass.  | 
|  2.9.1  |  Versión actualizada para el lanzamiento de la versión 2.9.1 del núcleo de Greengrass.  | 
|  2.9.0  | Versión actualizada para el lanzamiento de la versión 2.9.0 del núcleo de Greengrass. | 
|  2.8.1  |  Versión actualizada para el lanzamiento de la versión 2.8.1 del núcleo de Greengrass.  | 
|  2.8.0  | Versión actualizada para el lanzamiento de la versión 2.8.0 del núcleo de Greengrass. | 
|  2.7.0  |  Versión actualizada para el lanzamiento de la versión 2.7.0 del núcleo de Greengrass.  | 
|  2.6.0  |  <a name="changelog-greengrass-cli-2.6.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.5.6  |  Versión actualizada para el lanzamiento de la versión 2.5.6 del núcleo de Greengrass.  | 
|  2.5.5  |  Versión actualizada para el lanzamiento de la versión 2.5.5 del núcleo de Greengrass.  | 
|  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 del núcleo de Greengrass.  | 
|  2.5.2  |  Versión actualizada para el lanzamiento de la versión 2.5.2 del núcleo de Greengrass.  | 
|  2.5.1  |  Versión actualizada para el lanzamiento de la versión 2.5.1 del núcleo de Greengrass.  | 
|  2.5.0  |  <a name="changelog-greengrass-cli-2.5.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.4.0  |  <a name="changelog-greengrass-cli-2.4.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.3.0  |  Versión actualizada para el lanzamiento de la versión 2.3.0 del núcleo de Greengrass.  | 
|  2.2.0  |  Versión actualizada para el lanzamiento de la versión 2.2.0 del núcleo de Greengrass.  | 
|  2.1.0  |  Versión actualizada para el lanzamiento de la versión 2.1.0 del núcleo de Greengrass.  | 
|  2.0.5  | Versión actualizada para el lanzamiento de la versión 2.0.5 del núcleo de Greengrass. | 
|  2.0.4  | Versión actualizada para el lanzamiento de la versión 2.0.4 del núcleo de Greengrass. | 
|  2.0.3  |  Versión inicial.  |