安装程序参数 - AWS IoT Greengrass

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

安装程序参数

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

-h, --help

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

--version

(可选)显示AWS IoT Greengrass核心软件的版本。

-Droot

(可选)用作AWS IoT Greengrass核心软件根目录的文件夹路径。

注意

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

默认值:

  • 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_userggc_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