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

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

安装程序参数

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

-h, --help

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

--version

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

-Droot

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

注意

此参数设置 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 GreengrassCe 软件预配置Amazon IoT东西,(可选)一个Amazon IoT事物组、IAM 角色和Amazon IoT角色别名。

默认值:false

-tn, --thing-name

(可选)的名称Amazon IoT你注册为这个核心设备的东西。如果有这个名字的东西不存在于你的Amazon Web Services 账户,Amazon IoT Greengrass核心软件创造了它。

注意

事物名中不得含有冒号 (:) characters.

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

默认值:GreengrassV2IotThing_外加一个随机的 UUID。

-tgn, --thing-group-name

(可选)的名称Amazon IoT在其中添加此核心设备的事物组Amazon IoTthing. 如果部署以此事物组为目标,则此核心设备在连接到时会收到该部署Amazon IoT Greengrass. 如果具有此名称的事物组不存在于您的Amazon Web Services 账户,Amazon IoT Greengrass核心软件创造了它。

注意

事物组名中不得含有冒号 (:) characters.

您必须指定。--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 初始化系统。

重要

在 Windows 核心设备上,您必须设置Amazon IoT Greengrass核心软件即系统服务。

默认值: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此核心设备的组件。您可以使用此工具来开发和调试此核心设备上的组件。

重要

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

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

默认值:false

-init, --init-config

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

重要

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

-tp, --trusted-plugin

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

-s, --start

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

默认值:true