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: Conceitos básicos do 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: Conceitos básicos do 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. Na página aws.greengrass.Cli, escolha Implantar.

  5. Em Adicionar à implantação, escolha Criar nova implantaçã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.Clicomponente está 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ção avançada, mantenha as configurações padrão e escolha Avançar.

  10. Na página de revisão, clique em Implantar

  1. No seu dispositivo, crie um deployment.json arquivo para definir a configuração de implantação do componente GreengrassCLI. Esse arquivo deve ter a seguinte aparência:

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.13.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 dos 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 dos 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.