本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS IoT Greengrass 開發套件命令列界面 (GDK CLI) 提供可協助您開發自訂 Greengrass 元件的功能。您可以使用 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://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 裝置,則 install 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 1.1.0 版及更新版本。
-
變更記錄
下表說明每個 GDK CLI 版本中的變更。如需詳細資訊,請參閱 GitHub 上的 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 |
初始版本。 |