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 principal inclui um instalador que configura o software e provisiona os AWS recursos necessários para a execução do dispositivo principal do Greengrass. O instalador inclui os seguintes argumentos que você pode especificar para configurar a instalação:

-h, --help

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

--version

(Opcional) Mostre 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 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

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

-p, --provision

(Opcional) Você pode registrar esse dispositivo como uma AWS IoT coisa e provisionar os AWS recursos que o dispositivo principal exige. Se você especificartrue, o software AWS IoT Greengrass Core provisiona qualquer AWS IoT coisa, (opcional) qualquer grupo de AWS IoT coisas, uma função do IAM e um alias de AWS IoT função.

Padrão: false

-tn, --thing-name

(Opcional) O nome da AWS IoT coisa que você registra como esse dispositivo principal. Se a coisa com o nome não existir no seuConta da AWS, o software AWS IoT Greengrass Core a cria.

nota

O nome da coisa não pode conter caracteres de dois pontos (:).

Você deve especificar --provision true para aplicar esse argumento.

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

-tgn, --thing-group-name

(Opcional) O nome do grupo de AWS IoT coisas em que você adiciona o item desse dispositivo AWS IoT principal. Se uma implantação tem como alvo esse grupo de coisas, esse dispositivo principal recebe essa implantação quando se conecta AWS IoT Greengrass a. Se o grupo de coisas com esse nome não existir no seuConta da AWS, o software AWS IoT Greengrass Core o criará.

nota

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

Você deve especificar --provision true para aplicar esse argumento.

-tpn, --thing-policy-name

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

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

O software AWS IoT Greengrass Core cria uma AWS IoT política permissiva por padrão. Você pode definir o escopo dessa política ou criar uma política personalizada na qual restrinja as permissões para seu caso de uso. Para ter mais informações, consulte AWS IoTPolítica mínima para dispositivos AWS IoT Greengrass V2 principais.

Você deve especificar --provision true para aplicar esse argumento.

Padrão: GreengrassV2IoTThingPolicy

-trn, --tes-role-name

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

Você deve especificar --provision true para aplicar esse argumento.

Padrão: GreengrassV2TokenExchangeRole

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

(Opcional) O nome do alias da AWS IoT função que aponta para a função do IAM que fornece AWS credenciais para esse dispositivo principal. Se o alias de função com esse nome não existir no seuConta da AWS, o software AWS IoT Greengrass Core o criará e o direcionará para a função do IAM que você especificar.

Você deve especificar --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 ter mais informações, consulte Configurar o núcleo do Greengrass 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, você deve 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.

Em sistemas operacionais Linux, você também pode especificar opcionalmente o grupo. Especifique o usuário e o grupo separados por dois pontos. Por exemplo, ggc_user:ggc_group.

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

  • Se você executar como root, 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 existirem ggc_user ou ggc_group não, o software os cria.

  • Se você executa como usuário não root, o software AWS IoT Greengrass Core usa esse usuário para executar componentes.

  • Se você não especificar um grupo, o software AWS IoT Greengrass Core usa o grupo primário do usuário do sistema.

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

-d, --deploy-dev-tools

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

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.

Você deve especificar --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. Você pode usar essa opção para configurar novos dispositivos principais com uma configuração de núcleo específica, por exemplo.

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 provisionamentopersonalizado, 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 principal após a instalação e, opcionalmente, provisionar recursos.

Padrão: true