选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据，以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用，但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意，AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容，包括相关广告。要接受或拒绝所有非必要 Cookie，请单击“接受”或“拒绝”。要做出更详细的选择，请单击“自定义”。

首选项
联系我们
反馈
AWS Documentation
创建 AWS 账户

Greengrass CLI

PDF
RSS
聚焦模式
Greengrass CLI - AWS IoT Greengrass
版本类型操作系统要求依赖项配置本地日志文件更改日志

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

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

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

您可以在安装 C AWS IoT Greengrass ore 软件时安装此组件。有关更多信息，请参阅 教程：入门 AWS 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
anchoranchor
/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"
anchoranchor
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"

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

版本

此组件具有以下版本：

  • 2.14.x

  • 2.13.x

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

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

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

操作系统

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

  • Linux

  • Windows

要求

此组件具有以下要求：

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

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

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

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

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

依赖项

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

2.14.0 – 2.14.1

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

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.12.0 <2.15.0 软性
2.13.0

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

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.12.0 <2.14.0 软性
2.12.0 – 2.12.6

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

anchoranchoranchoranchoranchoranchoranchoranchoranchoranchoranchoranchoranchoranchoranchor

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

依赖关系 兼容版本 依赖关系类型
Greengrass Nucleus >=2.12.0 <2.15.0 软性

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

配置

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

2.5.x - 2.13.x
AuthorizedPosixGroups

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

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

AuthorizedWindowsGroups

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

如果您未指定要授权的任何群组，则可以以管理员或运行 Core 软件的系统用户身份使用 Greengrass CLI。 AWS 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 与核心软件进行交互。 AWS IoT Greengrass 您可以指定组名或群组 IDs。例如，group1,1002,group3 授权三个系统组（group1、1002 和 group3）使用 Greengrass CLI。

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

例 示例：配置合并更新

以下示例配置指定授权三个系统组（group1、1002 和 group3）使用 Greengrass CLI。

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

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

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

AuthorizedWindowsGroups

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

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

例 示例：配置合并更新

以下示例配置指定授权三个 POSIX 系统组（group1、1002 和 group3）和两个 Windows 用户组（Device Operators 和 QA Engineers）使用 Greengrass CLI。

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}

本地日志文件

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

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

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

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

更改日志

下表介绍每个组件版本的更改。

版本

更改

2.14.1

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

emrfs
警告

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

错误修复和改进

  • 验证 cli 命令中的部署目标参数。

2.13.0

对 Greengrass Nucleus 版本 2.13.0 发行版进行了版本更新。

2.12.6

对 Greengrass Nucleus版本 2.12.6 发行版进行了版本更新。

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
新特征

  • 添加了对系统资源限制的支持。在创建本地部署时，您可以配置每个组件的进程可在核心设备上使用的最大 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

初始版本。

本页内容

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。