Instale o Greengrass CLI - AWS IoT Greengrass
Pré-requisitosImplemente o componente Greengrass CLI

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á.

Instale o Greengrass CLI

Você pode instalar o Greengrass CLI de uma das seguintes formas:

  • 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 CLI componente Greengrass (aws.greengrass.Cli) em seu dispositivo.

Esta seção descreve as etapas para implantar o componente GreengrassCLI. Para obter informações sobre a instalação do Greengrass CLI durante a configuração inicial, consulte. Tutorial: Começando com AWS IoT Greengrass V2

Pré-requisitos

Para implantar o CLI componente Greengrass, você deve atender aos seguintes requisitos:

  • AWS IoT Greengrass Software principal instalado e configurado em seu dispositivo principal. Para obter mais informações, consulte Tutorial: Começando com AWS IoT Greengrass V2.

  • Para usar o AWS CLI para implantar o GreengrassCLI, você deve ter instalado e configurado o. AWS CLI Para obter mais informações, consulte Configuração da AWS CLI no Guia do usuário da AWS Command Line Interface .

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

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

Implemente o componente Greengrass CLI

Conclua as etapas a seguir para implantar o CLI componente Greengrass em seu dispositivo principal:

  1. Faça login no console do AWS IoT Greengrass.

  2. No menu de navegação, escolha Componentes.

  3. Na página Componentes, na guia Componentes públicos, escolha aws.greengrass.Cli.

  4. Sobre o aws.greengrass.Clipágina, escolha Implantar.

  5. Em Adicionar à implementação, selecione Criar nova implementação.

  6. 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.

  7. Na página Selecionar componentes, verifique se o aws.greengrass.Clio componente é selecionado e escolha Avançar.

  8. Na página Configurar componentes, mantenha as configurações padrão e escolha Avançar.

  9. Na página Definir configurações avançadas, mantenha as configurações padrão e escolha Avançar.

  10. Na página Revisar, escolha Implantar.

  1. No seu dispositivo, crie um deployment.json arquivo para definir a configuração de implantação do componente GreengrassCLI. Esse arquivo deve ser semelhante ao seguinte:

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • No target campo, targetArn substitua pelo Amazon Resource Name (ARN) da coisa ou grupo de coisas a ser destinado para a implantação, no seguinte formato:

      • 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

      A versão do componente GreengrassCLI.

      configurationUpdate.AuthorizedPosixGroups

      (Opcional) Uma string que contém uma lista separada por vírgulas de grupos do sistema. Você autoriza esses grupos do sistema a usar o CLI Greengrass para interagir com AWS IoT Greengrass o software principal. Você pode especificar nomes de grupos ou gruposIDs. Por exemplo, group1,1002,group3 autoriza três grupos do sistema (group11002, egroup3) a usar o GreengrassCLI.

      Se você não especificar nenhum grupo para autorizar, poderá usar o CLI Greengrass como usuário raiz sudo () 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 do sistema a usar o CLI Greengrass para interagir com AWS IoT Greengrass o software principal. Você pode especificar nomes de grupos ou gruposIDs. Por exemplo, group1,1002,group3 autoriza três grupos do sistema (group11002, egroup3) a usar o GreengrassCLI.

      Se você não especificar nenhum grupo para autorizar, poderá usar o CLI Greengrass como administrador ou como usuário do sistema que AWS IoT Greengrass executa o software Core.

  2. Execute o comando a seguir para implantar o CLI componente 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 na /greengrass/v2/bin pasta do seu dispositivo e você executa o Greengrass a CLI partir desse caminho. Para executar o Greengrass CLI sem seu caminho absoluto, adicione sua /greengrass/v2/bin pasta à sua PATH variável. Para verificar a CLI instalação 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=<ggcRootPath>] [COMMAND]
Greengrass command line interface

      --ggcRootPath=<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 o greengrass-cli não for encontrado, a implantação pode ter falhado ao instalar o GreengrassCLI. Para obter mais informações, consulte Solução de problemas AWS IoT Greengrass V2.