As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

O componente da CLI do Greengrass (`aws.greengrass.Cli`) fornece uma interface de linha de comando local que você pode usar nos dispositivos principais para desenvolver e depurar componentes localmente. A CLI do Greengrass permite criar implantações locais e reiniciar componentes no dispositivo principal, por exemplo.

Você pode instalar esse componente ao instalar o software AWS IoT Greengrass Core. Para obter mais informações, consulte [Tutorial: Conceitos básicos do AWS IoT Greengrass V2](getting-started.md).

**Importante**  
 <a name="local-dev-tools-production-environment-warning"></a>Recomendamos que você use este componente somente em ambientes de desenvolvimento, não em ambientes de produção. Este componente fornece acesso a informações e operações que você normalmente não precisará em um ambiente de produção. Siga o princípio do privilégio mínimo implantando este componente somente nos dispositivos principais em que você precisar dele. 

Depois de instalar esse componente, execute o comando a seguir para ver a documentação de ajuda. Quando esse componente é instalado, ele adiciona um link simbólico à `greengrass-cli` na pasta `/greengrass/v2/bin`. É possível executar a CLI do Greengrass a partir desse caminho ou adicioná-la à sua variável de ambiente `PATH` para executar a `greengrass-cli` sem o caminho absoluto.

------
#### [ Linux or Unix ]

```
/greengrass/v2/bin/greengrass-cli help
```

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

```
C:\greengrass\v2\bin\greengrass-cli help
```

------

O comando a seguir reinicia um componente chamado `com.example.HelloWorld`, por exemplo.

------
#### [ 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 obter mais informações, consulte [Interface de linha de comando do Greengrass](gg-cli.md).

**Topics**
+ [Versões](#greengrass-cli-component-versions)
+ [Tipo](#greengrass-cli-component-type)
+ [Sistema operacional](#greengrass-cli-component-os-support)
+ [Requisitos](#greengrass-cli-component-requirements)
+ [Dependências](#greengrass-cli-component-dependencies)
+ [Configuração](#greengrass-cli-component-configuration)
+ [Arquivo de log local](#greengrass-cli-component-log-file)
+ [Changelog](#greengrass-cli-component-changelog)

## Versões
<a name="greengrass-cli-component-versions"></a>

Esse componente tem as seguintes versões:
+ 2,16.x
+ 2,15x
+ 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 é um componente de plug-in (`aws.greengrass.plugin`). O [Greengrass nucleus](greengrass-nucleus-component.md) executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo é reiniciado quando você altera a versão desse componente no dispositivo principal.

<a name="public-component-type-plugin-para2"></a>Esse componente usa o mesmo arquivo de log do Greengrass nucleus. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obter mais informações, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

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

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:
+ Linux
+ Windows

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

Esse componente tem os seguintes requisitos:
+ <a name="greengrass-cli-authorization-requirement"></a>Você deve estar autorizado a usar a CLI do Greengrass para interagir com o software principal. AWS IoT Greengrass Siga um dos seguintes procedimentos para usar a Greengrass CLI:
  + Use o usuário do sistema que executa o software AWS IoT Greengrass Core.
  + Use um usuário com permissões de root ou administrativas. Nos dispositivos principais do Linux, você pode usar `sudo` para obter permissões de root.
  + Use um usuário do sistema que esteja em um grupo que você especifica nos parâmetros de `AuthorizedWindowsGroups` configuração `AuthorizedPosixGroups` ou ao implantar o componente. Para mais informações, consulte [Configuração do componente da CLI do Greengras](#greengrass-cli-component-configuration).
+ O componente da CLI do Greengrass é compatível para execução em uma VPC.

## Dependências
<a name="greengrass-cli-component-dependencies"></a>

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das [versões lançadas](#greengrass-cli-component-changelog) desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no [console do AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). Na página de detalhes do componente, procure a lista de **dependências**.

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

A tabela a seguir lista as dependências da versão 2.16.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2,12,0 <2,17,0 | Flexível | 

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

A tabela a seguir lista as dependências da versão 2.15.1 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2,12,0 <2,16,0 | Flexível | 

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

A tabela a seguir lista as dependências da versão 2.15.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2,12,0 <2,16,0 | Flexível | 

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

A tabela a seguir lista as dependências das versões 2.14.0 e 2.14.3 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2,12,0 <2,15,0 | Flexível | 

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

A tabela a seguir lista as dependências da versão 2.13.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Flexível | 

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

A tabela a seguir lista as dependências para as versões 2.12.0 a 2.12.6 deste componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Flexível | 

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

A tabela a seguir lista as dependências das versões 2.11.0 a 2.11.3 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Flexível | 

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

A tabela a seguir lista as dependências das versões 2.10.0 a 2.10.3 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flexível | 

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

A tabela a seguir lista as dependências das versões 2.9.0 a 2.9.6 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flexível | 

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

A tabela a seguir lista as dependências para as versões 2.8.0 e 2.8.1 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Flexível | 

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

A tabela a seguir lista as dependências da versão 2.7.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Flexível | 

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

A tabela a seguir lista as dependências para a versão 2.6.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Flexível | 

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

A tabela a seguir lista as dependências das versões 2.5.0 a 2.5.6 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Flexível | 

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

A tabela a seguir lista as dependências para a versão 2.4.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Flexível | 

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

A tabela a seguir lista as dependências para a versão 2.3.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Flexível | 

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

A tabela a seguir lista as dependências para a versão 2.2.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Flexível | 

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

A tabela a seguir lista as dependências da versão 2.1.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Flexível | 

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

A seguinte tabela lista as dependências da versão 2.0.x desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.1.0 | Flexível | 

**nota**  
A versão mínima compatível do Greengrass nucleus corresponde à versão de patch do componente da CLI do Greengrass. 

------

Para obter mais informações sobre as dependências dos componentes, consulte [referência de fórmula do componente](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuração
<a name="greengrass-cli-component-configuration"></a>

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

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

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Opcional) Uma string que contém uma lista separada por vírgulas de grupos do sistema. Você autoriza esses grupos de sistema a usar a CLI do Greengrass para interagir com AWS IoT Greengrass o software principal. Você pode especificar nomes de grupos ou grupos IDs. Por exemplo, `group1,1002,group3` autoriza três grupos do sistema (`group1``1002`, e`group3`) a usar a CLI do Greengrass.  
Se você não especificar nenhum grupo para autorizar, poderá usar a CLI do Greengrass como `sudo` usuário raiz () ou como usuário do sistema que AWS IoT Greengrass executa o software Core.

`AuthorizedWindowsGroups`  <a name="greengrass-cli-component-configuration-authorizedwindowsgroups"></a>
(Opcional) Uma string que contém uma lista separada por vírgulas de grupos do sistema. Você autoriza esses grupos de sistema a usar a CLI do Greengrass para interagir com AWS IoT Greengrass o software principal. Você pode especificar nomes de grupos ou grupos IDs. Por exemplo, `group1,1002,group3` autoriza três grupos do sistema (`group1``1002`, e`group3`) a usar a CLI do Greengrass.  
Se você não especificar nenhum grupo para autorizar, poderá usar a CLI do Greengrass como administrador ou como usuário do sistema que AWS IoT Greengrass executa o software Core.

**Example Exemplo: atualização da mesclagem de configuração**  
O exemplo de configuração a seguir especifica a autorização de três grupos de sistema POSIX (`group1`, `1002` e `group3`) e dois grupos de usuários do Windows (`Device Operators` e `QA Engineers`) para usar a CLI do 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) Uma sequência de caracteres que contém uma lista separada por vírgulas de grupos de sistema. Você autoriza esses grupos de sistema a usar a CLI do Greengrass para interagir com AWS IoT Greengrass o software principal. Você pode especificar nomes de grupos ou grupos IDs. Por exemplo, `group1,1002,group3` autoriza três grupos do sistema (`group1``1002`, e`group3`) a usar a CLI do Greengrass.  
Se você não especificar nenhum grupo para autorizar, poderá usar a CLI do Greengrass como `sudo` usuário raiz () ou como usuário do sistema que AWS IoT Greengrass executa o software Core.

**Example Exemplo: atualização da mesclagem de configuração**  
O exemplo de configuração a seguir especifica a autorização de três grupos do sistema (`group1`, `1002` e `group3`) a usar a CLI do Greengrass.  

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

------

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

Esse componente usa o mesmo arquivo de log do componente de [Greengrass nucleus](greengrass-nucleus-component.md).

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

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

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

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

------

**Para ver os logs desse componente**
+ Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua `/greengrass/v2` ou *C:\$1greengrass\$1v2* pelo caminho para a pasta AWS IoT Greengrass raiz.

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

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="greengrass-cli-component-changelog"></a>

A tabela a seguir descreve as alterações em cada versão do componente.


|  **Versão**  |  **Alterações**  | 
| --- | --- | 
|  2.16.1  |  Versão atualizada para a versão 2.16.1 do Greengrass nucleus.  | 
|  2.16.0  |  Versão atualizada para a versão 2.16.0 do Greengrass nucleus.  | 
|  2.15.1  |  Versão atualizada para a versão 2.15.1 do Greengrass nucleus.  | 
|  2.15.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.14.3  |  Versão atualizada para o Greengrass nucleus versão 2.14.3.  | 
|  2.14.2  |  Versão atualizada para o Greengrass nucleus versão 2.14.2.  | 
|  2.14.1  |  Versão atualizada para o Greengrass nucleus versão 2.14.1.  | 
|  2.14.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.13.0  |  Versão atualizada para o lançamento da versão 2.13.0 do núcleo do Greengrass.  | 
|  2.12.6  |  Versão atualizada para o Greengrass nucleus versão 2.12.6.  | 
|  2.12.5  |  Versão atualizada para o Greengrass nucleus versão 2.12.5.  | 
|  2.12.4  |  Versão atualizada para o Greengrass nucleus versão 2.12.4.  | 
|  2.12.3  |   Esta versão não está mais disponível. As melhorias nesta versão estão disponíveis em versões posteriores desse componente.  Versão atualizada para o Greengrass nucleus versão 2.12.3.  | 
|  2.12.2  |  Versão atualizada para o Greengrass nucleus versão 2.12.2.  | 
|  2.12.1  |  Versão atualizada para o Greengrass nucleus versão 2.12.1.  | 
|  2.12.0  |  Versão atualizada para o núcleo do Greengrass 2.12.0.  | 
|  2.11.3  |  Versão atualizada para o Greengrass nucleus versão 2.11.3.  | 
|  2.11.2  |  Versão atualizada para o Greengrass nucleus versão 2.11.2.  | 
|  2.11.1  |  Versão atualizada para o Greengrass nucleus versão 2.11.1.  | 
|  2.11.0  |  <a name="changelog-cli-2.11.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.10.3  |  Versão atualizada para o Greengrass nucleus versão 2.10.3.  | 
|  2.10.2  |  Versão atualizada para o Greengrass nucleus versão 2.10.2.  | 
|  2.10.1  |  Versão atualizada para o Greengrass nucleus versão 2.10.1.  | 
|  2.10.0  |  Versão atualizada para o lançamento da versão 2.10.0 do núcleo do Greengrass.  | 
|  2.9.6  |  Versão atualizada para o Greengrass nucleus versão 2.9.6.  | 
|  2.9.5  |  Versão atualizada para o Greengrass nucleus versão 2.9.5.  | 
|  2.9.4  |  Versão atualizada para o Greengrass nucleus versão 2.9.4.  | 
|  2.9.3  |  Versão atualizada para o Greengrass nucleus versão 2.9.3.  | 
|  2.9.2  |  Versão atualizada para o Greengrass nucleus versão 2.9.2.  | 
|  2.9.1  |  Versão atualizada para o Greengrass nucleus versão 2.9.1.  | 
|  2.9.0  | Versão atualizada para o núcleo do Greengrass 2.9.0. | 
|  2.8.1  |  Versão atualizada para o Greengrass nucleus versão 2.8.1.  | 
|  2.8.0  | Versão atualizada para o lançamento da versão 2.8.0 do núcleo do Greengrass. | 
|  2.7.0  |  Versão atualizada para o lançamento da versão 2.7.0 do núcleo do 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/pt_br/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.5.6  |  Versão atualizada para o Greengrass nucleus versão 2.5.6.  | 
|  2.5.5  |  Versão atualizada para o Greengrass nucleus versão 2.5.5.  | 
|  2.5.4  |  Versão atualizada para o Greengrass nucleus versão 2.5.4.  | 
|  2.5.3  |  Versão atualizada para o Greengrass nucleus versão 2.5.3.  | 
|  2.5.2  |  Versão atualizada para o Greengrass nucleus versão 2.5.2.  | 
|  2.5.1  |  Versão atualizada para o Greengrass nucleus versão 2.5.1.  | 
|  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/pt_br/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/pt_br/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.3.0  |  Versão atualizada para o lançamento da versão 2.3.0 do núcleo do Greengrass.  | 
|  2.2.0  |  Versão atualizada para o lançamento do núcleo do Greengrass versão 2.2.0.  | 
|  2.1.0  |  Versão atualizada para o lançamento do núcleo do Greengrass versão 2.1.0.  | 
|  2.0.5  | Versão atualizada para o Greengrass nucleus versão 2.0.5. | 
|  2.0.4  | Versão atualizada para o Greengrass nucleus versão 2.0.4. | 
|  2.0.3  |  Versão inicial.  |