本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
安装程序参数
AWS IoT GreengrassCore 软件包括一个安装程序,用于设置软件并配置 Greengrass 核心设备运行所需的AWS资源。安装程序包含以下参数,您可以指定这些参数来配置安装:
-h
,--help
-
(可选)显示安装程序的帮助信息。
--version
-
(可选)显示AWS IoT Greengrass核心软件的版本。
-Droot
-
(可选)用作AWS IoT Greengrass核心软件根目录的文件夹路径。
注意
此参数设置 JVM 属性,因此您必须在运行安装程序之前
-jar
指定该属性。例如,指定java -Droot="
。
" -jar /path/to/Greengrass.jar/greengrass/v2
默认值:
-
Linux:
~/.greengrass
-
Windows:
%USERPROFILE%/.greengrass
-
-ar
,--aws-region
-
AWS IoT Greengrass核心软件用来检索或创建其所需AWS资源的。AWS 区域
-p
,--provision
-
(可选)您可以将此设备注册为AWS IoT事物,并配置核心设备所需的AWS资源。如果您指定
true
,则AWS IoT Greengrass核心软件会预置一个AWS IoT事物、(可选)一个AWS IoT事物组、一个 IAM 角色和一个AWS IoT角色别名。默认值:
false
-tn
,--thing-name
-
(可选)您注册为该核心设备的设备名称。AWS IoT如果你的名字中不存在这个名字AWS 账户,那么 AWS IoT Greengrass Core 软件就会创建它。
注意
事物名称不能包含冒号 (
:
) 字符。必须指定
--provision true
才能应用此参数。默认:
GreengrassV2IotThing_
加上一个随机的 UUID。 -tgn
,--thing-group-name
-
(可选)您在其中添加此核心设备AWS IoT的事AWS IoT物组的名称。如果部署以该事物组为目标,则该核心设备在连接到时会收到该部署AWS IoT Greengrass。如果您中不存在具有此名称的事物组AWS 账户,则 AWS IoT Greengrass Core 软件会创建它。
注意
事物组名称不能包含冒号 (
:
) 字符。必须指定
--provision true
才能应用此参数。 -tpn
,--thing-policy-name
-
此功能适用于 Greengrass nucleus 组件的 v2.4.0 及更高版本。
(可选)要附加到该核心设备AWS IoT的事物证书的AWS IoT策略名称。如果您的AWS IoT策略中不存在带有此名称的策略AWS 账户,则由 AWS IoT Greengrass Core 软件创建该策略。
默认情况下,AWS IoT GreengrassCore 软件会创建宽松AWS IoT策略。您可以缩小此策略的范围,也可以创建自定义策略来限制用例的权限。有关更多信息,请参阅 AWS IoT Greengrass V2核心设备的最低AWS IoT政策。
必须指定
--provision true
才能应用此参数。默认值:
GreengrassV2IoTThingPolicy
-trn
,--tes-role-name
-
(可选)用于获取允许核心设备与AWS服务交互的AWS证书的 IAM 角色的名称。如果您的角色中不存在具有此名称的角色AWS 账户,则AWS IoT Greengrass核心软件会使用
GreengrassV2TokenExchangeRoleAccess
策略创建该角色。此角色无权访问托管组件工件的 S3 存储桶。因此,在创建组件时,必须为工件的 S3 存储桶和对象添加权限。有关更多信息,请参阅 授权核心设备与 AWS 服务交互。必须指定
--provision true
才能应用此参数。默认值:
GreengrassV2TokenExchangeRole
-tra
,--tes-role-alias-name
-
(可选)指向为该AWS IoT核心设备提供AWS证书的 IAM 角色的角色别名的名称。如果您的中不存在具有此名称的角色别名AWS 账户,则 AWS IoT Greengrass Core 软件会创建该别名并将其指向您指定的 IAM 角色。
必须指定
--provision true
才能应用此参数。默认值:
GreengrassV2TokenExchangeRoleAlias
-ss
,--setup-system-service
-
(可选)您可以将 AWS IoT Greengrass Core 软件设置为在该设备启动时运行的系统服务。系统服务名称是
greengrass
。有关更多信息,请参阅 将 Greengrass 核心配置为系统服务。在 Linux 操作系统上,此参数要求设备上有 systemd 初始化系统。
重要
在 Windows 核心设备上,必须将AWS IoT Greengrass核心软件设置为系统服务。
默认值:
false
-u
,--component-default-user
-
C AWS IoT Greengrass ore 软件用于运行组件的用户的名称或 ID。例如,您可以指定
ggc_user
。在 Windows 操作系统上运行安装程序时,必须使用此值。在 Linux 操作系统上,您也可以选择指定组。指定用冒号分隔的用户和组。例如,
ggc_user:ggc_group
。以下其他注意事项适用于 Linux 操作系统:
-
如果您以 root 身份运行,则默认组件用户是在配置文件中定义的用户。如果配置文件未定义用户,则默认为
ggc_user:ggc_group
。如果存在ggc_user
或ggc_group
不存在,则由软件创建它们。 -
如果您以非 root 用户身份运行,则 AWS IoT Greengrass Core 软件将使用该用户来运行组件。
-
如果您未指定组,则 AWS IoT Greengrass Core 软件将使用系统用户的主组。
有关更多信息,请参阅 配置运行组件的用户。
-
-d
,--deploy-dev-tools
-
(可选)您可以将 Greengrass CLI 组件下载并部署到该核心设备上。您可以使用此工具在此核心设备上开发和调试组件。
重要
我们建议您仅在开发环境中使用此组件,而不是在生产环境中使用。此组件提供对生产环境中通常不需要的信息和操作的访问。遵循最低权限原则,将此组件仅部署到需要的核心设备。
必须指定
--provision true
才能应用此参数。默认值:
false
-init
,--init-config
-
(可选)用于安装AWS IoT Greengrass核心软件的配置文件的路径。例如,您可以使用此选项来设置具有特定 nucleus 配置的新核心设备。
重要
您指定的配置文件与核心设备上的现有配置文件合并。这包括核心设备上的组件和组件配置。我们建议配置文件仅列出您正在尝试更改的配置。
-tp
,--trusted-plugin
-
(可选)要作为可信插件加载的 JAR 文件的路径。使用此选项提供配置插件 JAR 文件,例如使用队列配置或自定义配置进行安装,或者使用私钥和证书安装在硬件安全模块中。
-s
,--start
-
(可选)您可以在安装AWS IoT Greengrass核心软件后启动它,也可以选择配置资源。
默认值:
true