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

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

Greengrass I

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

您可以在安装Amazon IoT Greengrass Core 软件时安装此组件。有关更多信息,请参阅 教程:Amazon IoT Greengrass V2 入门

重要

,,,,,,,,,,,,,,。 此组件提供对生产环境中通常不需要的信息和操作的访问。遵循最小权限原则,将此组件仅部署到您需要的核心设备。

,,,,,,,,,。安装此组件时,它会在/greengrass/v2/bin文件夹greengrass-cli中添加符号链接。您可以从此路径运行 Greengrass CLI,也可以将其添加到您的PATH环境变量中,以便在没有绝对路径greengrass-cli的情况下运行。

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

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

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

有关更多信息,请参阅 Greengrass Command Line Interface

版本

此组件有以下版本:

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.0 with

类型

这个组件是一个插件组件 (aws.greengrass.plugin)。Greengrass 核心在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当您在核心设备上更改此组件的版本时,nucleus 会重新启动。

此组件使用与 Greengrass 核相同的日志文件。有关更多信息,请参阅 显示器Amazon IoT Greengrass圆木

有关更多信息,请参阅 组件类型

操作系统

此组件可以安装在运行以下操作系统的核心设备上:

  • Linux

  • Windows

要求

此组件有以下要求:

  • 您必须获得授权才能使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。Greengrass CLI:

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

    • 使用具有 root 权限或管理权限的用户。在 Linux 核心设备上,您可以使用sudo获得根权限。

    • 使用您在部署组件时在AuthorizedPosixGroupsAuthorizedWindowsGroups配置参数中指定的组中的系统用户。,Greengrass CLI CLI

附属物

部署组件时,Amazon IoT Greengrass还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件已发布版本的依赖关系以及为每个依赖项定义组件版本的语义版本约束。您还可以在Amazon IoT Greengrass控制台中查看每个版本组件的依赖关系。在组件详细信息页面上,查找 “依赖关系” 列表。

2.8.0 and 2.8.1

下表列出了此组件版本 2.8.0 和 2.8.1 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.5.0 <2.9.0 软性
2.7.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.5.0 <2.8.0 软性
2.6.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.5.0 <2.7.0 软性
2.5.0 - 2.5.6

下表列出了此组件版本 2.5.0 到 2.5.6 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.5.0 <2.6.0 软性
2.4.0

下表列出了此组件 2.4.0 版的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.5.0 软性
2.3.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.4.0 软性
2.2.0

2.0 with Passenger 2.0 with Passenger 2.2.0。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.3.0 软性
2.1.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.1.0 <2.2.0 软性
2.0.x

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.0.0 <2.1.0 软性
注意

Greengrass 核心的最低兼容版本对应于 Greengrass CLI 组件的补丁版本。

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

配置

此组件提供以下配置参数,您可以在部署组件时对其进行自定义。

2.5.x
AuthorizedPosixGroups

(Polita),,4。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。您可以指定组名或群组 ID。例如,group1,1002,group3授权三个系统组(group11002、和group3)使用 Greengrass CLI。

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

AuthorizedWindowsGroups

(Polita),,4。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。您可以指定组名或群组 ID。例如,group1,1002,group3授权三个系统组(group11002、和group3)使用 Greengrass CLI。

如果您未指定任何要授权的组,则可以以管理员或运行Amazon IoT Greengrass核心软件的系统用户身份使用 Greengrass CLI。

例 示例:配置合并更新

以下示例配置指定授权三个 POSIX 系统组(group11002、和group3)和两个 Windows 用户组(Device OperatorsQA Engineers)使用 Greengrass CLI。

{ "AuthorizedPosixGroups": "group1,1002,group3", "AuthorizedWindowsGroups": "Device Operators,QA Engineers" }
2.4.x - 2.0.x
AuthorizedPosixGroups

(Polita),,4。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。您可以指定组名或群组 ID。例如,group1,1002,group3授权三个系统组(group11002、和group3)使用 Greengrass CLI。

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

例 示例:配置合并更新

以下示例配置指定授权三个系统组(group11002、和group3)使用 Greengrass CLI。

{ "AuthorizedPosixGroups": "group1,1002,group3" }

Loga Pass

此组件使用与 Greengrass 核心组件相同的日志文件。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看此组件的日志文件。将 /greengrass/v2C:\greengrass\v2 替换为Amazon IoT Greengrass根文件夹的路径。

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

更改日志

Passenger Passenger。

Version

变更

2.8.0

Greengrass nucleus 2.8.0。

2.7.0

Greengrass nucleus 2.7.0。

2.6.0

新功能
  • 增加了对自定义组件的支持,以调用 Greengrass CLI 使用的进程间通信 (IPC) 操作。您可以使用这些 IPC 操作来管理本地部署、查看组件详细信息以及生成可用于登录本地调试控制台的密码。,IPC:管理本地部署和组件

2.5.6

为 Greengrass nucleus 版本 2.5.6 版本更新了版本。

2.5.5

Greengrass nucleus 2.5.5。

2.5.4

Greengrass nucleus 2.5.4。

2.5.3

Greengrass nucleus 2.5.3。

2.5.2

Greengrass nucleus 2.5.2。

2.5.1

Greengrass nucleus 2.5.1。

2.5.0

新功能
  • 增加了对运行 Windows 的核心设备的支持。

  • 添加了新的AuthorizedWindowsGroups配置参数,您可以指定该参数来授权系统组在 Windows 设备上使用 Greengrass CLI。

  • 为本地部署添加windowsUser参数。您可以使用此参数指定用于在 Windows 核心设备上运行组件的用户。

2.4.0

新功能

2.3.0

Greengrass nucleus 2.3.0。

2.2.0

Greengrass nucleus 2.2.0。

2.1.0

Greengrass nucleus 2.1.0。

2.0.5

Greengrass nucleus 2.0.5。

2.0.4

Greengrass nucleus 2.0.4。

2.0.3

初始版本。