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

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

Amazon IoT Greengrass开发套件命令行界面

这些区域有:Amazon IoT Greengrass开发工具包命令行界面 (GDK CLI) 提供了帮助您开发的功能自定义 Greengrass 组件. 您可以使用 GDK CLI 创建、构建和发布自定义组件。当您使用 GDK CLI 创建组件存储库时,您可以从模板或社区组件从Greengrass 软件目录. 然后,您可以选择将文件打包为 ZIP 存档文件、使用 Maven 或 Gradle 构建脚本或运行自定义构建命令的构建系统。创建组件后,您可以使用 GDK CLI 将其发布到Amazon IoT Greengrass服务,所以您可以使用Amazon IoT Greengrass控制台或 API 来将组件部署到 Greengrass 核心设备。

在没有 GDK CLI 的情况下开发 Greengrass 组件时,必须在组件配方文件每次创建组件的新版本时。当您使用 GDK CLI 时,它可以在每次发布组件的新版本时自动更新版本并为您创建 URI。

GDK CLI 是开源的,可在 GitHub 上使用。您可以自定义和扩展 GDK CLI 以满足组件开发需求。我们邀请您在 GitHub 存储库。你可以通过以下链接找到 GDK CLI 源代码:https://github.com/aws-greengrass/aws-greengrass-gdk-cli.

先决条件

要安装和使用 Greengrass 开发套件 CLI,您需要以下内容:

  • 一个 Amazon Web Services 账户。如果没有,请参阅设置Amazon Web Services 账户

  • 具有互联网连接的 Windows、macOS 或类 Unix 的开发计算机。

  • 对于 GDK CLI 版本 1.1.0 或更高版本,Python在开发计算机上安装 3.6 或更高版本。

    对于 GDK CLI 版本 1.0.0,Python在开发计算机上安装 3.8 或更高版本。

  • 饭桶已安装在开发计算机上。

  • Amazon Command Line Interface(Amazon CLI) 在开发计算机上安装和配置凭据。有关更多信息,请参阅 。安装、更新和卸载Amazon CLI配置Amazon CLI中的Amazon Command Line Interface用户指南.

    注意

    如果你使用树莓派或其他 32 位 ARM 设备,请安装Amazon CLIV1。Amazon CLIV2 不适用于 32 位 ARM 设备。有关更多信息,请参阅 。安装、更新和卸载Amazon CLI版本 1.

  • 使用 GDK CLI 将组件发布到Amazon IoT Greengrass服务,您必须具有以下权限:

    • s3:CreateBucket

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • 要使用 GDK CLI 构建一个组件,其构件存在于 S3 存储桶中而不是本地文件系统中,您必须拥有s3:ListBucket权限。

    此功能适用于 GDK CLI v1.1.0 及更高版本。

更改日志

下表介绍了 GDK CLI 各个版本的更改。有关更多信息,请参阅 。GDK CLI 发布页面(位于 GitHub 上)。

Version

更改

1.1.0

新功能
  • 添加对 Gradle 的支持构建系统.

  • 添加对 Maven 的支持构建系统在 Windows 设备上。

  • 添加--bucket对的参数发布组件命令。您可以使用此参数指定 GDK CLI 上传组件项目的确切存储桶。

  • 添加--name对的参数组件 init命令。您可以使用此选项指定 GDK CLI 初始化组件的文件夹。

  • 添加对 S3 存储桶中但不存在于本地组件构建文件夹中的组件工件的支持。您可以使用此功能降低大型组件工件(例如机器学习模型)的带宽成本。

错误修复和改进
  • 更新发布组件命令来检查组件是否在发布组件之前构建了组件。如果没有构建组件,那么现在这个命令构建组件为你。

  • 修复了 ZIP 文件名包含大写字母时,zip 编译系统无法在 Windows 设备上构建的问题。

  • 改进了日志消息格式并将默认日志级别更改为INFO在运行 3.8 之前的 Python 版本的设备上。

  • 将最低 Python 版本要求更改为 Python 3.6。

1.0.0

初始版本。