本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
AWS IoT Greengrass 开发套件命令行界面 (GDK CLI) 提供的功能可帮助您开发自定义 Gre engrass 组件。您可以使用 GDK CLI 来创建、构建和发布自定义组件。使用 GDK CLI 创建组件存储库时,可以从 Greengrass 软件目录中的模板或社区组件开始。然后,您可以选择可将文件打包为 ZIP 存档、使用 Maven 或 Gradle 构建脚本或运行自定义构建命令的构建系统。创建组件后,您可以使用 GDK CLI 将其发布到 AWS IoT Greengrass 服务,这样您就可以使用 AWS IoT Greengrass 控制台或 API 将该组件部署到您的 Greengrass 核心设备上。
在没有 GDK CLI 的情况下开发 Greengrass 组件时,每次创建组件的新版本时,都必须更新组件配方文件中的版本和 URIs 工件。当您使用 GDK CLI 时,它可以在您每次发布组件的新版本时自动为您更新版本和构件。 URIs
GDK CLI 是开源的,可在上使用。 GitHub您可以自定义和扩展 GDK CLI 以满足您的组件开发需求。我们邀请您在 GitHub 仓库中打开议题和拉取请求。您可以通过以下链接找到 GDK CLI 源代码:https://github.com/aws-greengrass/aws-greengrass-gdk-cli
先决条件
要安装和使用 Greengrass 开发工具包 CLI,需要以下条件:
-
一个 AWS 账户。如果没有,请参阅设置一个 AWS 账户。
-
支持互联网连接的 Windows、macOS 或类 Unix 的开发计算机。
-
对于 GDK CLI 1.1.0 版本或更高版本,开发计算机上需已安装 Python
3.6 或更高版本。 对于 GDK CLI 1.0.0 版本,开发计算机上需已安装 Python
3.8 或更高版本。 -
开发计算机上已安装 Git
。 -
AWS Command Line Interface (AWS CLI) 已在开发计算机上安装并使用凭据进行配置。有关更多信息,请参阅《AWS Command Line Interface 用户指南》中的安装、更新和卸载 AWS CLI 以及配置 AWS CLI。
注意
如果您使用 Raspberry Pi 或其他 32 位 ARM 设备,请安装 AWS CLI V1。 AWS CLI V2 不适用于 32 位 ARM 设备。有关更多信息,请参阅安装、更新和卸载 AWS CLI 版本 1。
-
要使用 GDK CLI 向 AWS IoT Greengrass 服务发布组件,您必须具有以下权限:
-
s3:CreateBucket
-
s3:GetBucketLocation
-
s3:PutObject
-
greengrass:CreateComponentVersion
-
greengrass:ListComponentVersions
-
-
要使用 GDK CLI 构建其构件存在于 S3 存储桶(而不是本地文件系统)中的组件,必须拥有以下权限:
-
s3:ListBucket
此功能适用于 GDK CLI v1.1.0 及更高版本。
-
更改日志
下表介绍每个版本的 GDK CLI 的更改。有关更多信息,请参阅上的 GDK CLI 版本页面
版本 |
更改 |
---|---|
1.6.2 |
|
1.6.1 |
|
1.6.0 |
|
1.5.0 |
|
1.4.0 |
|
1.3.0 |
|
1.2.3 |
|
1.2.2 |
|
1.2.1 |
|
1.2.0 |
|
1.1.0 |
|
1.0.0 |
初始版本。 |