格林格拉斯命令行界面 - Amazon IoT Greengrass
版本类型操作系统要求附属物配置本地日志文件更改日志
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

格林格拉斯命令行界面

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

可以在安装时安装此组件Amazon IoT Greengrass核心软件。有关更多信息，请参阅教程：Amazon IoT Greengrass V2 入门：

重要

我们建议您仅在开发环境中使用此组件，而不是在生产环境中使用。此组件提供对生产环境中通常不需要的信息和操作的访问。遵循最小权限原则，将此组件仅部署到需要它的核心设备上。

安装此组件后，运行以下命令以查看其帮助文档。安装此组件时，它会添加一个符号链接greengrass-cli在/greengrass/v2/bin文件夹。你可以从这个路径运行 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"

有关更多信息，请参阅Gmmmmmmmmmm：

版本

此组件有以下版本：

  • 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）。这个绿草核在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当您在核心设备上更改此组件的版本时，nucleus 会重新启动。

此组件使用与 Greengrass 核相同的日志文件。有关更多信息，请参阅监控Amazon IoT Greengrass日志：

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

操作系统

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

  • Linux

  • Windows

要求

此组件有以下要求：

  • 您必须获得授权才能使用 Greengrass CLI 与Amazon IoT Greengrass核心软件。要使用 Greengrass CLI，请执行以下操作之一：

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

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

    • 使用您在中指定的群组中的系统用户AuthorizedPosixGroups要么AuthorizedWindowsGroups部署组件时的配置参数。有关更多信息，请参见格林格拉斯 CLI 组件配置。

附属物

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

2.11.0 – 2.11.2

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

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

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

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

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

依赖关系 兼容版本 依赖关系类型
绿草核 >=2.5.0 <2.10.0 软性
2.8.0 – 2.8.1

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

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

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

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

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

依赖关系 兼容版本 依赖关系类型
绿草核 >=2.5.0 <2.7.0 软性
2.5.0 – 2.5.6

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

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

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

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

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

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

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

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

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

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

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

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

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

有关组件依赖关系的更多信息，请参见组件配方参考。

配置

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

2.5.x
AuthorizedPosixGroups

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

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

AuthorizedWindowsGroups

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

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

例 示例：配置合并更新

以下示例配置指定授权三个 POSIX 系统组 (group1，1002，以及group3) 和两个 Windows 用户组 (Device Operators和QA 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授权三个系统组 (group1，1002，以及group3) 使用 Greengrass CLI。

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

例 示例：配置合并更新

以下示例配置指定对三个系统组进行授权 (group1，1002，以及group3) 使用 Greengrass CLI。

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

本地日志文件

此组件使用与相同的日志文件绿草核组件。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
查看此组件的日志

  • 在核心设备上运行以下命令以实时查看此组件的日志文件。替换/greengrass/v2要么C:\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.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
新功能

  • 增加了对系统资源限制的支持。创建本地部署时，可以配置每个组件的进程可以在核心设备上使用的最大 CPU 和 RAM 使用量。有关更多信息，请参见为组件配置系统资源限制还有部署创建命令。

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

初始版本。