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 podem ser especificados para configurar a instalação:

-h, --help

(Opcional) Mostra 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, 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

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 seu Conta da AWS, o software AWS IoT Greengrass Core a cria.

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 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 seu Conta da AWS, o software AWS IoT Greengrass Core 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 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 sua Conta 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 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 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 sua Conta da AWS, o software AWS IoT Greengrass Core a criará com a GreengrassV2TokenExchangeRoleAccess política. 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 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 seu Conta da AWS, o software AWS IoT Greengrass Core o criará e o direcionará para a função do IAM que você especificar.

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

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

Padrão: true