Argumentos de instalação - AWS IoT 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á.

Argumentos de instalação

O software AWS IoT Greengrass Core inclui um instalador que configura o software e provisiona os recursos da AWS necessários para a execução do dispositivo principal do Greengrass. O instalador inclui os seguintes argumentos que podem ser especificados para configurar a instalação:

-h, --help

(Opcional) Mostra as informações de ajuda do instalador.

--version

(Opcional) Mostra a versão do software AWS IoT Greengrass Core.

-Droot

(Opcional) O caminho para a pasta a ser usada como raiz do software AWS IoT Greengrass Core.

nota

Esse argumento define uma propriedade da JVM, portanto, você deve especificá-la antes de -jar, ao executar o instalador. Por exemplo, especifique  java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar.

Padrão:

  • Linux: ~/.greengrass

  • Windows: : %USERPROFILE%/.greengrass

-ar, --aws-region

A Região da AWS que o software AWS IoT Greengrass Core usa para recuperar ou criar os recursos da AWS necessários.

-p, --provision

(Opcional) É possível registrar esse dispositivo como um objeto da AWS IoT e provisionar os recursos da AWS que o dispositivo principal exige. Se você especificar true, o software AWS IoT Greengrass Core provisiona qualquer objeto da AWS IoT, (opcional) qualquer grupo de objetos da AWS IoT, um perfil do IAM e um alias de perfil da AWS IoT.

Padrão: false

-tn, --thing-name

(Opcional) O nome do objeto da AWS IoT que você registra como esse dispositivo principal. Se o objeto com o nome não existir na sua Conta da AWS, o software AWS IoT Greengrass Core o criará.

nota

O nome do objeto não pode conter caracteres de dois pontos (:).

Especifique --provision true para aplicar esse argumento.

Padrão: GreengrassV2IotThing_ mais um UUID aleatório.

-tgn, --thing-group-name

(Opcional) O nome do grupo de objetos da AWS IoT em que você adiciona o objeto da AWS IoT desse dispositivo principal. Se uma implantação tem como alvo esse grupo de coisas, esse dispositivo principal recebe essa implantação quando se conecta ao AWS IoT Greengrass. Se o grupo de coisas com esse nome não existir na sua Conta da AWS, o software de núcleo do AWS IoT Greengrass o criará.

nota

O nome do grupo de objetos não pode conter caracteres de dois pontos (:).

Especifique --provision true para aplicar esse argumento.

-tpn, --thing-policy-name

Esse recurso está disponível para a versão 2.4.0 e posteriores do componente de núcleo do Greengrass.

(Opcional) O nome da política de AWS IoT a ser anexada ao certificado de objeto da AWS IoT desse dispositivo principal. Se a política de AWS IoT com esse nome não existir na sua Conta da AWS, o software AWS IoT Greengrass Core a criará.

O software AWS IoT Greengrass Core cria uma política de AWS IoT permissiva por padrão. Você pode restringir essa política ou criar uma política personalizada na qual você restringe as permissões para seu caso de uso. Para obter mais informações, consulte AWS IoT Política mínima para dispositivos AWS IoT Greengrass V2 principais.

Especifique --provision true para aplicar esse argumento.

Padrão: GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(Opcional) O nome do perfil do IAM a ser usado para adquirir credenciais da AWS que permitem que o dispositivo principal interaja com os serviços da AWS. Se o perfil com esse nome não existir na sua Conta da AWS, o software AWS IoT Greengrass Core o criará com a política de GreengrassV2TokenExchangeRoleAccess. Esse perfil não tem acesso aos buckets do S3 nos quais você hospeda artefatos de componentes. Portanto, adicione permissões aos buckets e objetos do S3 dos seus artefatos ao criar um componente. Para obter mais informações, consulte Autorize os dispositivos principais a interagir com os serviços da AWS.

Especifique --provision true para aplicar esse argumento.

Padrão: GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(Opcional) O nome do alias do perfil da AWS IoT que aponta para o perfil do IAM que fornece credenciais da AWS para esse dispositivo principal. Se o alias do perfil com esse nome não existir na Conta da AWS, o software AWS IoT Greengrass Core o criará e o apontará para o perfil do IAM especificado por você.

Especifique --provision true para aplicar esse argumento.

Padrão: GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(Opcional) Você pode configurar o software AWS IoT Greengrass Core como um serviço do sistema que é executado quando esse dispositivo é inicializado. O nome do serviço do sistema é greengrass. Para obter mais informações, consulte Configurar o Greengrass nucleus como um serviço do sistema.

Em sistemas operacionais Linux, esse argumento exige que o sistema init systemd esteja disponível no dispositivo.

Importante

Nos dispositivos principais do Windows, é preciso configurar o software AWS IoT Greengrass Core como um serviço do sistema.

Padrão: false

-u, --component-default-user

O nome ou ID do usuário que o software AWS IoT Greengrass Core usa para executar componentes. Por exemplo, é possível especificar ggc_user. Esse valor é necessário quando você executa o instalador nos sistemas operacionais Windows.

Como opção, você também pode especificar o grupo nos sistemas operacionais Linux. Especifique o usuário e o grupo separando-os por dois pontos. Por exemplo, ggc_user:ggc_group.

As seguintes considerações adicionais se aplicam aos sistemas operacionais Linux:

  • Se você executar como raiz, o usuário padrão do componente é o usuário definido no arquivo de configuração. Se o arquivo de configuração não definir um usuário, o padrão será ggc_user:ggc_group. Se ggc_user ou ggc_group não existirem, o software os cria.

  • Se você executar como um usuário não raiz, o software AWS IoT Greengrass Core usará esse usuário para executar componentes.

  • Caso um grupo não seja especificado, o software AWS IoT Greengrass Core usará o grupo primário do usuário do sistema.

Para obter mais informações, consulte Configurar o usuário que executa os componentes.

-d, --deploy-dev-tools

(Opcional) Você pode baixar e implantar o componente da CLI do Greengrass nesse dispositivo principal. Você pode usar essa ferramenta para desenvolver e depurar componentes nesse dispositivo principal.

Importante

Recomendamos que você use este componente somente em ambientes de desenvolvimento, não em ambientes de produção. Este 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 privilégio mínimo implantando este componente somente nos dispositivos principais em que você precisar dele.

Especifique --provision true para aplicar esse argumento.

Padrão: false

-init, --init-config

(Opcional) O caminho para o arquivo de configuração a ser usado para instalar o software AWS IoT Greengrass Core. Por exemplo, você pode usar essa opção para configurar novos dispositivos principais com uma configuração de núcleo específica.

Importante

O arquivo de configuração que você especifica se mescla com o arquivo de configuração existente no dispositivo principal. Isso inclui os componentes e as configurações dos componentes no dispositivo principal. Recomendamos que o arquivo de configuração liste somente as configurações que você está tentando alterar.

-tp, --trusted-plugin

(Opcional) O caminho para um arquivo JAR a ser carregado como um plug-in confiável. Use essa opção para fornecer arquivos JAR do plug-in de provisionamento, como para instalar com provisionamento de frota ou provisionamento personalizado, ou para instalar com a chave privada e o certificado em um módulo de segurança de hardware.

-s, --start

(Opcional) Você pode iniciar o software AWS IoT Greengrass Core após a instalação e, opcionalmente, provisionar recursos.

Padrão: true