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

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

Greengrass CLI

Greengrass CLI 组件 (aws.greengrass.Cli)提供了一个本地命令行界面,您可以在核心设备上使用该接口在本地开发和调试组件。例如,Greengrass CLI 允许您在核心设备上创建本地部署并重新启动组件。

您可以在安装 AWS IoT Greengrass 核心软件时安装此组件。有关更多信息,请参阅 AWS IoT Greengrass V2 入门

安装此组件后,请运行以下命令来查看其帮助文档。当安装此组件时,它会将一个符号链接添加到greengrass-cli中的/greengrass/v2/binfolder。您可以从此路径运行 Greengrass CLI,或将其添加到PATH要运行的环境变量greengrass-cli没有绝对路径.

/greengrass/v2/bin/greengrass-cli help

以下命令将重新启动名为com.example.HelloWorld,例如。

sudo /greengrass/v2/bin/greengrass-cli component restart \ --names "com.example.HelloWorld"

有关更多信息,请参阅 Greengrass 命令行界面

Versions

此组件具有以下版本:

  • 2.0.x

Requirements

此组件具有以下要求:

  • 您必须获得授权才能使用 Greengrass CLI 与 AWS IoT Greengrass 核心软件进行交互。执行以下操作之一以使用 Greengrass CLI:

    • 使用 root 用户 (sudo)。

    • 使用运行 AWS IoT Greengrass Core 软件的系统用户。

    • 使用系统用户,该用户位于您在已授权的对象组配置参数。

Dependencies

当您部署组件时,AWS IoT Greengrass 还会部署其依赖关系的兼容版本。您必须满足组件及其所有依赖关系的要求才能成功部署组件。本部分列出了发布版本以及定义每个依赖关系的组件版本的语义版本约束。您也可以在组件的中查看组件的依赖关系。AWS IoT Greengrass 控制台。在组件详细信息页面上,查找附属物列表。

2.1.x

下表列出了此组件 2.1.x 版本的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核心 ~2.1.0 软性
2.0.x

下表列出了此组件 2.0.x 版本的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核心 >2.0 x <2.1.0 软性
注意

Greengrass 核的最低兼容版本与 Greengrass CLI 组件的修补程序版本相对应。

有关组件依赖项的更多信息,请参阅。组件配方参考

Configuration

此组件提供了以下配置参数,您可以在部署组件时自定义这些参数。

AuthorizedPosixGroups

(可选)包含以逗号分隔的系统组列表的字符串。您授权这些系统组使用 Greengrass CLI 与 AWS IoT Greengrass 核心软件进行交互。您可以指定组名或组 ID。例如,group1,1002,group3授权三个系统组(group11002, 和group3)使用 Greengrass CLI。

如果您没有指定任何要授权的组,则可以使用 Greengrass CLI 作为根用户 (sudo)或作为运行 AWS IoT Greengrass 核心软件的系统用户。

Changelog

下表描述了代码示例目录的更改。

Version

更改

2.1.0

版本更新了 Greengrass 核版本 2.1.0。

2.0.5

版本更新了 Greengrass 核版本 2.0.5。

2.0.4

版本更新了 Greengrass 核版本 2.0.4。

2.0.3

初始版本。