安装程序参数 - 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_group 或 ggc_user。

  • 如果您以根用户身份运行，则默认为配置文件定义的用户和组。如果配置文件未定义用户和组，则默认为 ggc_user:ggc_group。如果 ggc_user 或 ggc_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