安装程序参数 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

安装程序参数

这些区域有:Amazon IoT Greengrass核心软件包括一个安装程序,用于设置软件并配置所需Amazon资源,以便 Greengrass 核心设备运行。安装程序包括以下参数,您可以指定这些参数来配置安装:

-h, --help

(可选)显示安装程序的帮助信息。

--version

(可选)显示Amazon IoT GreengrassCore 软件。

-Droot

(可选)文件夹的路径,用作Amazon IoT GreengrassCore 软件。

注意

此参数设置 JVM 属性,因此您必须在-jar运行安装程序时。例如,指定java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar.

默认值:~/.greengrass

-ar, --aws-region

这些区域有:Amazon Web Services 区域的Amazon IoT Greengrass核心软件用于检索或创建其所需Amazon资源的费用。

-p, --provision

(可选)您可以将此设备注册为Amazon IoT事物并提供Amazon核心设备所需的资源。如果您指定true,Amazon IoT Greengrass核心软件预配置Amazon IoT事情,(可选)Amazon IoT事物组、IAM 角色和Amazon IoT角色别名。

默认值:false

-tn, --thing-name

(可选)Amazon IoT你注册为这个核心设备的东西。如果名称的东西不存在于Amazon Web Services 账户,Amazon IoT Greengrass核心软件创建它。

注意

事物名中不得含有冒号(:) 字符。

您必须指定--provision true来应用此参数。

默认值:GreengrassV2IotThing_加上随机 UUID。

-tgn, --thing-group-name

(可选)Amazon IoT事物组中添加此核心设备的Amazon IoT事物。如果部署以此事物组为目标,则此核心设备在连接到Amazon IoT Greengrass. 如果具有此名称的事物组不存在于Amazon Web Services 账户,Amazon IoT Greengrass核心软件创建它。

注意

事物组名称不能包含冒号(:) 字符。

您必须指定--provision true来应用此参数。

-tpn, --thing-policy-name

此功能适用于 v2.4.0 及更高版本的Greengrass 核组件.

(可选)Amazon IoT策略连接到此核心设备的Amazon IoT事物证书。如果Amazon IoT策略中不存在于Amazon Web Services 账户,Amazon IoT Greengrass核心软件创建它。

这些区域有:Amazon IoT Greengrass核心软件创建了一个宽容Amazon IoT策略。您可以缩小此策略的范围,或者创建一个自定义策略,在其中限制您的使用案例的权限。有关更多信息,请参阅最低Amazon IoT用于 的 策略Amazon IoT Greengrass V2核心设备

您必须指定--provision true来应用此参数。

默认值:GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(可选)用于获取的 IAM 角色的名称Amazon凭据,使核心设备与Amazon服务。如果具有此名称的角色不存在于Amazon Web Services 账户,Amazon IoT Greengrass核心软件使用GreengrassV2TokenExchangeRoleAccess政策。此角色无权访问您在其中托管组件工件的 S3 存储桶。因此,在创建组件时,您必须向对象的 S3 存储桶和对象添加权限。有关更多信息,请参阅授权核心设备与Amazon服务

您必须指定--provision true来应用此参数。

默认值:GreengrassV2TokenExchangeRole

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

(可选)Amazon IoT角色别名,指向提供的 IAM 角色Amazon此核心设备的凭据。如果具有此名称的角色别名不存在于Amazon Web Services 账户,Amazon IoT Greengrass核心软件将创建它并将其指向您指定的 IAM 角色。

您必须指定--provision true来应用此参数。

默认值:GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(可选)您可以设置Amazon IoT Greengrass核心软件作为系统服务,在此设备启动时运行。系统服务名称为greengrass. 有关更多信息,请参阅配置Amazon IoT Greengrass作为系统服务

此参数要求 systemd init 系统在设备上可用。

默认值:false

-u, --component-default-user

(可选)系统用户和组的名称或 ID,Amazon IoT Greengrass核心软件用于运行组件。指定用冒号分隔的用户和组。该组是可选的。举例来说,可以指定 ggc_user:ggc_groupggc_user

  • 如果以 root 用户身份运行,则默认为配置文件定义的用户和组。如果配置文件未定义用户和组,则默认为ggc_user:ggc_group. 如果ggc_user或者ggc_group不存在,软件会创建它们。

  • 如果以非 root 用户身份运行,Amazon IoT Greengrass核心软件使用该用户运行组件。

  • 如果您没有指定组,则Amazon IoT Greengrass核心软件使用系统用户的主要组。

有关更多信息,请参阅配置运行组件的用户和组

-d, --deploy-dev-tools

(可选)您可以从下载并部署Greengrass CLI CLI组件添加到核心设备。您可以使用此工具开发和调试此核心设备上的组件。

重要

本地开发工具仅供在开发环境中使用。不要在生产设备上指定此选项。

您必须指定--provision true来应用此参数。

默认值:false

-init, --init-config

(可选)配置文件的路径,用于安装Amazon IoT GreengrassCore 软件。例如,您可以使用此选项来设置具有特定核心配置的新核心设备。

重要

您指定的配置文件将替换核心设备上的现有配置文件。这将删除现有配置,其中包括核心设备上的组件和组件配置。

-tp, --trusted-plugin

(可选)JAR 文件的路径以作为受信任插件加载。使用此选项可以提供预配插件 JAR 文件,例如使用队列预置或者自定义预置.

-s, --start

(可选)您可以启动Amazon IoT Greengrass安装后的核心软件,并(可选)配置资源。

默认值:true