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á.
# Instalar a Greengrass CLI
É possível instalar a CLI do Greengrass de uma das seguintes maneiras:
+ Use o `--deploy-dev-tools` argumento ao configurar o software AWS IoT Greengrass Core pela primeira vez em seu dispositivo. Você também deve especificar `--provision true` para aplicar esse argumento.
+ Implante o componente CLI do Greengrass (`aws.greengrass.Cli`) em seu dispositivo.
Esta seção descreve as etapas para implantar o componente Greengrass CLI. Para obter informações sobre como instalar a Greengrass CLI durante a configuração inicial, consulte [Tutorial: Conceitos básicos do AWS IoT Greengrass V2](getting-started.md).
## Pré-requisitos
Para implantar o componente Greengrass CLI, é necessário atender aos seguintes requisitos:
+ AWS IoT Greengrass Software principal instalado e configurado em seu dispositivo principal. Para obter mais informações, consulte [Tutorial: Conceitos básicos do AWS IoT Greengrass V2](getting-started.md).
+ Para usar o AWS CLI para implantar a CLI do Greengrass, você deve ter instalado e configurado o. AWS CLI Para obter mais informações, consulte [Configuração da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) no *Guia do usuário da AWS Command Line Interface *.
+ 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.md#greengrass-cli-component-configuration).
## Implemente o componente CLI do Greengrass
Conclua as etapas a seguir para implantar o componente Greengrass CLI em seu dispositivo principal:
### Para implantar o componente Greengrass CLI (console)
1. Faça login no [console do AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).
1. No menu de navegação, escolha **Componentes**.
1. Na página **Componentes**, na guia **Componentes públicos**, escolha `aws.greengrass.Cli`.
1. Na página **aws.greengrass.Cli**, escolha **Implantar**.
1. Em **Adicionar à implementação**, selecione **Criar nova implementação**.
1. **Na página **Especificar destino**, em **Alvos de implantação**, na lista **Nome do alvo**, escolha o grupo Greengrass no qual você deseja implantar e escolha Avançar.**
1. Na página **Selecionar componentes**, verifique se o componente **aws.greengrass.Cli** está selecionado e escolha **Avançar**.
1. Na página **Configurar componentes**, mantenha as configurações padrão e escolha **Avançar**.
1. Na página **Definir configurações avançadas**, mantenha as configurações padrão e escolha **Avançar**.
1. Na página **Revisar**, escolha **Implantar**.
### Para implantar o componente CLI do Greengrass ()AWS CLI
1. No seu dispositivo, crie um `deployment.json` arquivo para definir a configuração de implantação do componente Greengrass CLI. Esse arquivo deve ser semelhante ao seguinte:
```
{
"targetArn":"targetArn",
"components": {
"aws.greengrass.Cli": {
"componentVersion": "2.16.1",
"configurationUpdate": {
"merge": "{\"AuthorizedPosixGroups\":\",,...,\",\"AuthorizedWindowsGroups\":\",,...,\"}"
}
}
}
}
```
+ No campo `target`, substitua `targetArn` pelo nome do recurso da Amazon (ARN) da coisa ou do grupo de coisas do destino da implantação, no formato a seguir:
+ Coisa: `arn:aws:iot:region:account-id:thing/thingName`
+ Grupo de coisas: `arn:aws:iot:region:account-id:thinggroup/thingGroupName`
+ No objeto `aws.greengrass.Cli` componente, especifique os valores da seguinte forma:
`version`
Essa é a versão do componente Greengrass CLI.
`configurationUpdate.AuthorizedPosixGroups`
(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.
`configurationUpdate.AuthorizedWindowsGroups`
(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.
1. Execute o seguinte comando para implantar o componente da CLI do Greengrass no dispositivo:
```
$ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json
```
Durante a instalação, o componente adiciona um link simbólico à `greengrass-cli` `/greengrass/v2/bin` pasta do seu dispositivo e você executa a CLI do Greengrass a partir desse caminho. Para executar a CLI do Greengrass sem seu caminho absoluto, adicione sua `/greengrass/v2/bin` pasta à variável PATH. Para verificar a instalação da CLI do Greengrass, execute o seguinte comando:
------
#### [ Linux or Unix ]
```
/greengrass/v2/bin/greengrass-cli help
```
------
#### [ Windows ]
```
C:\greengrass\v2\bin\greengrass-cli help
```
------
A seguinte saída deverá ser mostrada:
```
Usage: greengrass-cli [-hV] [--ggcRootPath=] [COMMAND]
Greengrass command line interface
--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.
```
Se `greengrass-cli` não for encontrado, a implantação pode ter falhado ao instalar a CLI do Greengrass. Para obter mais informações, consulte [Solução de problemas AWS IoT Greengrass V2](troubleshooting.md).