CLI do Greengrass - AWS IoT Greengrass
VersõesTipoSistema operacionalRequisitosDependênciasConfiguraçãoArquivo de log localChangelog

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

O componente 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 ter mais informações, consulte Tutorial: Conceitos básicos do AWS IoT Greengrass V2.

Importante

Recomendamos que você use esse componente somente em ambientes de desenvolvimento, não em ambientes de produção. Esse 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 menor privilégio implantando esse componente somente nos dispositivos principais onde você precisar dele.

Depois de instalar esse componente, execute o comando a seguir para ver sua documentação de ajuda. Quando esse componente é instalado, ele adiciona um link simbólico greengrass-cli à /greengrass/v2/bin pasta. Você pode executar a CLI do Greengrass a partir desse caminho ou adicioná-la à sua variável de PATH ambiente para ser executada greengrass-cli sem seu 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 chamadocom.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 ter mais informações, consulte Interface de linha de comando do Greengrass.

Versões

Esse componente tem as seguintes versões:

  • 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 é um componente de plug-in (aws.greengrass.plugin). O núcleo do Greengrass executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo reinicia quando você altera a versão desse componente no dispositivo principal.

Esse componente usa o mesmo arquivo de log do núcleo do Greengrass. Para ter mais informações, consulte Monitore AWS IoT Greengrass os registros.

Para ter mais informações, consulte Tipos de componentes.

Sistema operacional

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

  • Linux

  • Windows

Requisitos

Esse componente tem os seguintes requisitos:

  • Você deve estar autorizado a usar a CLI do Greengrass para interagir com o software principal. AWS IoT Greengrass Faça o seguinte para usar a CLI do Greengrass:

    • 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 obter mais informações, consulte Configuração do componente CLI do Greengrass.

  • O componente Greengrass CLI tem suporte para ser executado em uma VPC.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que você deve atender aos requisitos do componente e de todas as suas dependências para implantá-lo com êxito. Esta seção lista as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões do componente para cada dependência. Você também pode visualizar as dependências de cada versão do componente no AWS IoT Greengrass console. Na página de detalhes do componente, procure a lista de dependências.

2.12.0 – 2.12.6

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=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
Núcleo Greengrass >=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
Núcleo Greengrass >=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
Núcleo Greengrass >=2.5.0 <2.10.0 Flexível
2.8.0 – 2.8.1

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=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
Núcleo Greengrass >=2,5.0 <2,8,0 Flexível
2.6.0

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=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
Núcleo Greengrass >=2,5.0 <2,6,0 Flexível
2.4.0

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.1.0 <2.5.0 Flexível
2.3.0

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.1.0 <2.4.0 Flexível
2.2.0

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=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
Núcleo Greengrass >=2.1.0 <2.2.0 Flexível
2.0.x

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

Dependência Versões compatíveis Tipo de dependência
Núcleo Greengrass >=2.0.0 <2.1.0 Flexível
nota

A versão mínima compatível do núcleo do Greengrass corresponde à versão de patch do componente CLI do Greengrass.

Para obter mais informações sobre dependências de componentes, consulte a referência da receita do componente.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente.

2.5.x - 2.12.x
AuthorizedPosixGroups

(Opcional) Uma string que contém uma lista separada por vírgulas dos 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 IDs de grupos. Por exemplo, group1,1002,group3 autoriza três grupos do sistema (group11002, egroup3) 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

(Opcional) Uma string que contém uma lista separada por vírgulas dos 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 IDs de grupos. Por exemplo, group1,1002,group3 autoriza três grupos do sistema (group11002, egroup3) 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.

exemplo Exemplo: atualização da mesclagem de configurações

O exemplo de configuração a seguir especifica a autorização de três grupos de sistema POSIX (group11002, egroup3) e dois grupos de usuários do Windows (Device OperatorseQA Engineers) para usar a CLI do Greengrass.

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

(Opcional) Uma string que contém uma lista separada por vírgulas dos 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 IDs de grupos. Por exemplo, group1,1002,group3 autoriza três grupos do sistema (group11002, egroup3) 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.

exemplo Exemplo: atualização da mesclagem de configurações

O exemplo de configuração a seguir especifica a autorização de três grupos do sistema (group11002, egroup3) a usar a CLI do Greengrass.

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

Arquivo de log local

Esse componente usa o mesmo arquivo de log do componente do núcleo do Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver os registros 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:\greengrass\v2 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 tabela a seguir descreve as alterações em cada versão do componente.

Version (Versão)

Alterações

2.12.6

Versão atualizada para a versão 2.12.6 do Greengrass nucleus.

2.12.5

Versão atualizada para a versão 2.12.5 do Greengrass nucleus.

2.12.4

Versão atualizada para a versão 2.12.4 do Greengrass nucleus.

2.12.3
Atenção

Essa 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 a versão 2.12.3 do Greengrass nucleus.

2.12.2

Versão atualizada para a versão 2.12.2 do Greengrass nucleus.

2.12.1

Versão atualizada para a versão 2.12.1 do Greengrass nucleus.

2.12.0

Versão atualizada para a versão 2.12.0 do Greengrass nucleus.

2.11.3

Versão atualizada para a versão 2.11.3 do Greengrass nucleus.

2.11.2

Versão atualizada para a versão 2.11.2 do Greengrass nucleus.

2.11.1

Versão atualizada para a versão 2.11.1 do Greengrass nucleus.

2.11.0
Novos atributos

  • Permite que você cancele uma implantação local.

  • Permite que você configure uma política de tratamento de falhas para uma implantação local.

  • Melhora os relatórios detalhados do status de implantação.

2.10.3

Versão atualizada para a versão 2.10.3 do Greengrass nucleus.

2.10.2

Versão atualizada para a versão 2.10.2 do Greengrass nucleus.

2.10.1

Versão atualizada para a versão 2.10.1 do Greengrass nucleus.

2.10.0

Versão atualizada para a versão 2.10.0 do Greengrass nucleus.

2.9.6

Versão atualizada para a versão 2.9.6 do Greengrass nucleus.

2.9.5

Versão atualizada para a versão 2.9.5 do Greengrass nucleus.

2.9.4

Versão atualizada para a versão 2.9.4 do Greengrass nucleus.

2.9.3

Versão atualizada para a versão 2.9.3 do Greengrass nucleus.

2.9.2

Versão atualizada para a versão 2.9.2 do Greengrass nucleus.

2.9.1

Versão atualizada para a versão 2.9.1 do Greengrass nucleus.

2.9.0

 Versão atualizada para a versão 2.9.0 do Greengrass nucleus.

2.8.1

Versão atualizada para a versão 2.8.1 do Greengrass nucleus.

2.8.0

 Versão atualizada para a versão 2.8.0 do Greengrass nucleus.

2.7.0

Versão atualizada para a versão 2.7.0 do Greengrass nucleus.

2.6.0
Novos atributos

  • Adiciona suporte para componentes personalizados para chamar operações de comunicação entre processos (IPC) que a CLI do Greengrass usa. Você pode usar essas operações de IPC para gerenciar implantações locais, visualizar detalhes do componente e gerar uma senha que pode ser usada para entrar no console de depuração local. Para obter mais informações, consulte IPC: gerenciar implantações e componentes locais.

Correções de erros e melhorias

  • Pequenas correções e melhorias adicionais.

2.5.6

Versão atualizada para a versão 2.5.6 do Greengrass nucleus.

2.5.5

Versão atualizada para a versão 2.5.5 do Greengrass nucleus.

2.5.4

Versão atualizada para a versão 2.5.4 do Greengrass nucleus.

2.5.3

Versão atualizada para a versão 2.5.3 do Greengrass nucleus.

2.5.2

Versão atualizada para a versão 2.5.2 do Greengrass nucleus.

2.5.1

Versão atualizada para a versão 2.5.1 do Greengrass nucleus.

2.5.0
Novos atributos

  • Adiciona suporte para dispositivos principais que executam o Windows.

  • Adiciona o novo parâmetro de AuthorizedWindowsGroups configuração que você pode especificar para autorizar grupos do sistema a usar a CLI do Greengrass em dispositivos Windows.

  • Adiciona o windowsUser parâmetro para implantações locais. Você pode usar esse parâmetro para especificar o usuário a ser usado para executar componentes em um dispositivo principal do Windows.

2.4.0
Novos atributos

2.3.0

Versão atualizada para a versão 2.3.0 do Greengrass nucleus.

2.2.0

Versão atualizada para a versão 2.2.0 do Greengrass nucleus.

2.1.0

Versão atualizada para a versão 2.1.0 do Greengrass nucleus.

2.0.5

 Versão atualizada para a versão 2.0.5 do Greengrass nucleus.

2.0.4

 Versão atualizada para a versão 2.0.4 do Greengrass nucleus.

2.0.3

Versão inicial.