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

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

Greengrass 命令行界面

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.9.x

  • 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.x

类型

此组件是插件组件 (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 组件配置

附属物

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

2.9.0 – 2.9.4

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

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

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

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

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

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

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

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

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

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

下表列出了此组件版本 2.4.0 版。

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

下表列出了此组件版本 2.3.0 版。

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

下表列出了此组件版本 2.0 版。

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

下表列出了此组件版本 2.1.0 版。

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

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

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

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

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

配置

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

2.5.x
AuthorizedPosixGroups

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

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

AuthorizedWindowsGroups

(可选)包含以逗号分隔的系统组逗号分隔列表。您授权这些系统组使用 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

(可选)包含以逗号分隔的系统组逗号分隔列表。您授权这些系统组使用 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" }

本地日志文件

该组件使用与 Greengrass nucleus 组件相同的日志文件。

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

更改日志

下表说明组件每个版本的更改。

Version

变更

2.9.4

版本更新为Greengrass nucles 版本 2.9.4 版。

2.9.3

版本更新为Greengrass nucleus 版本 2.9.3 版。

2.9.2

版本更新为Greengrass nucleus 版本 2.9.2 版。

2.9.1

版本更新为Greengrass nucleus 版本 2.9.1 版。

2.9.0

版本更新为Greengrass nucles 版本 2.9.0 版。

2.8.1

版本更新为Greengrass nucleus 版本 2.8.1 版。

2.8.0

版本更新为Greengrass nucleus 版本 2.8.0 版。

2.7.0

版本更新为Greengrass nucles 版本 2.7.0 版。

2.6.0

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

错误修复与改进
  • 其他细微修复和改进。

2.5.6

Greengrass nucleus 版本 2.5.6 版本的版本已更新。

2.5.5

版本更新为Greengrass nucles 版本 2.5.5 版。

2.5.4

版本更新为Greengrass nucles 版本 2.5.4 版。

2.5.3

版本更新为Greengrass nucles 版本 2.5.3 版。

2.5.2

版本更新为Greengrass nucles 版本 2.5.2 版。

2.5.1

版本更新为Greengrass nucles 版本 2.5.1 版。

2.5.0

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

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

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

2.4.0

新功能

2.3.0

版本更新为Greengrass nucles 版本 2.3.0 版。

2.2.0

版本更新为Greengrass nucleus 版本 2.0 版。

2.1.0

版本更新为Greengrass nucles 版本 2.1.0 版。

2.0.5

版本更新为Greengrass nucles 版本 2.0.版。

2.0.4

版本更新为Greengrass nucles 版本 2.0.4 版。

2.0.3

初始版本。