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

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

安装程序参数

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

-h, --help

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

--version

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

-Droot

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

注意

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

默认值: ~/.greengrass

-ar, --aws-region

AWS AWS IoT Greengrass Core 软件用于检索或创建其所需 AWS 资源的 AWS 区域。

-p, --provision

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

默认值: false

-tn, --thing-name

(可选)您注册为此核心设备的 AWS IoT IoT 事物的名称。如果名为 的事物在您的 AWS 账户中不存在 AWS IoT IoT Greengrass 核心软件将创建它。

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

默认值GreengrassV2IotThing_:加随机 UUID。

-tgn, --thing-group-name

(可选)添加此核心设备的 AWS IoT IoT 事物的 AWS AWS IoT 事物组的名称。如果部署以该事物组为目标,则此核心设备在连接到 AWS AWS IoT Greengrass 时会收到该部署。如果 AWS 账户中不存在具有此名称的事物组 AWS IoT IoT Greengrass 核心将创建它。

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

-trn, --tes-role-name

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

默认值: GreengrassV2TokenExchangeRole

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

(可选)指向为该核心设备提供 AWS 凭证的 IAM 角色的 AWS AWS IoT 角色别名的名称。如果 AWS 账户中不存在具有此名称的角色别名 AWS IoT IoT Greengrass 核心软件将创建该别名并将其指向您指定的 IAM 角色。

默认值: GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

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

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

默认值: false

-u, --component-default-user

(可选 AWS IoT IoT Greengrass Core 软件用于运行组件的系统用户和组的名称或 ID。指定以冒号分隔的用户和组。组是可选的。例如,您可以指定 ggc_user:ggc_groupggc_user

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

  • 如果您以非根用户身份运行 AWS IoT IoT Greengrass 核心软件将使用该用户来运行组件。

  • 如果未指定组 AWS IoT IoT Greengrass 核心软件将使用系统用户的主组。

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

-d, --deploy-dev-tools

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

重要

本地开发工具仅适用于 开发环境。请勿在生产设备上指定此选项。

默认值: false

-init, --init-config

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

重要

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

-s, --start

(可选)您可以在 AWS AWS IoT Greengrass 核心软件安装并(可选)预配置资源后启动它。

默认值: true