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

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

Greengrass CLI

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

您可以在安装 C Amazon IoT Greengrass ore 软件时安装此组件。有关更多信息,请参阅 教程: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 命令行界面

版本

此组件有以下版本:

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 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,请执行以下任一操作:

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

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

    • 部署组件时,请使用您在AuthorizedPosixGroupsAuthorizedWindowsGroups配置参数中指定的组中的系统用户。有关更多信息,请参阅 Greengrass CLI 组件配置。

  • 支持 Greengrass CLI 组件在 VPC 中运行。

依赖项

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

2.12.0 – 2.12.5

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.12.0 <2.13.0 软性
2.11.0 – 2.11.3

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.11.0 <2.12.0 软性
2.10.0 – 2.10.3

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

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

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

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.5.0 <2.10.0 软性
2.8.0 – 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.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 nucleus 的最低兼容版本对应于 Greengrass CLI 组件的补丁版本。

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

配置

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

2.5.x - 2.12.x
AuthorizedPosixGroups

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

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

AuthorizedWindowsGroups

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

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

例 示例:配置合并更新

以下示例配置指定授权三个 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。

如果您未指定要授权的任何群组,则可以以 root 用户 sudo () 或运行核心软件的系统用户身份使用 Greengrass CLI。 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

更改日志

下表描述了该组件的每个版本中的更改。

版本

更改

2.12.5

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

2.12.4

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

2.12.3

警告

此版本不再可用。此版本的改进将在此组件的更高版本中提供。

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

2.12.2

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

2.12.1

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

2.12.0

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

2.11.3

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

2.11.2

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

2.11.1

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

2.11.0

新功能
  • 允许您取消本地部署。

  • 使您能够为本地部署配置故障处理策略。

  • 改进了详细的部署状态报告。

2.10.3

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

2.10.2

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

2.10.1

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

2.10.0

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

2.9.6

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

2.9.5

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

2.9.4

Greengrass nucleus 版本 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 nucleus 版本 2.9.0 版本的版本已更新。

2.8.1

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

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

初始版本。