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

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 a CLI do Greengrass

Você pode instalar a CLI do Greengrass 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 componente CLI do Greengrass (aws.greengrass.Cli) em seu dispositivo.

Esta seção descreve as etapas para implantar o componente CLI do Greengrass. Para obter informações sobre a instalação da CLI do Greengrass durante a configuração inicial, consulte. Tutorial: Conceitos básicos do AWS IoT Greengrass V2

Pré-requisitos

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

  • AWS IoT Greengrass Software principal instalado e configurado em seu dispositivo principal. Para ter mais informações, consulte Tutorial: Conceitos básicos do AWS IoT Greengrass V2.

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

Implemente o componente CLI do Greengrass

Conclua as etapas a seguir para implantar o componente CLI do 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 CLI do Greengrass. Esse arquivo deve ter a seguinte aparência:

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

    • 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 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 Greengrass CLI.

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

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

  2. Execute o comando a seguir para implantar o componente 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=<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 greengrass-cli não for encontrado, a implantação pode ter falhado ao instalar a CLI do Greengrass. Para ter mais informações, consulte Solução de problemas AWS IoT Greengrass V2.