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

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

安装器参数

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

-h, --help

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

--version

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

-Droot

(可选)要用作根目录的文件夹的路径Amazon IoT GreengrassCore 软件。

注意

这个参数设置了一个 JVM 属性,所以你必须在之前指定它-jar运行安装程序时。例如,指定java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar.

默认值:

  • Linux:~/.greengrass

  • Windows: %USERPROFILE%/.greengrass

-ar, --aws-region

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

-p, --provision

(可选)您可以将此设备注册为Amazon IoT事情并提供Amazon核心设备需要的资源。如果你指定true,Amazon IoT GreengrassCore 软件预置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. 有关更多信息,请参阅 将 Greengrass 核配置为系统服务

在 Linux 操作系统上,此参数要求设备上提供 systemd init 系统。

默认值:false

-u, --component-default-user

用户的姓名或 IDAmazon IoT Greengrass核心软件用来运行组件。例如,您可以指定 ggc_user。在 Windows 操作系统上运行安装程序时,此值是必需的。

在 Linux 操作系统上,您还可以选择指定组。指定用冒号分隔的用户和组。例如,ggc_user:ggc_group

以下其他注意事项适用于 Linux 操作系统:

  • 如果以 root 身份运行,则默认组件用户是在配置文件中定义的用户。如果配置文件没有定义用户,则默认为ggc_user:ggc_group. 如果ggc_user要么ggc_group不存在,软件创建它们。

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

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

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

-d, --deploy-dev-tools

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

重要

我们建议您只在开发环境中使用此组件,而不要在生产环境中使用。此组件提供了对生产环境中通常不需要的信息和操作的访问权限。只将此组件部署到您需要的核心设备上,遵循最小特权原则。

您必须指定--provision true来应用这个论点。

默认值:false

-init, --init-config

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

重要

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

-tp, --trusted-plugin

(可选)要作为受信任插件加载的 JAR 文件的路径。使用此选项可以提供置备插件 JAR 文件,例如安装队列预置要么自定义预置,或者使用私钥和证书安装在硬件安全模块.

-s, --start

(可选)你可以启动Amazon IoT Greengrass核心软件在安装之后,还可以选择配置资源。

默认值:true