本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS IoT Greengrass開發套件命令列介面
開AWS IoT Greengrass發套件命令列介面 (GDK CLI) 提供的功能可協助您開發自訂 Greeng rass 元件。您可以使用 GDK CLI 來建立、建置和發佈自訂元件。使用 GDK CLI 建立元件存放庫時,您可以從 Greengr ass 軟體目錄中的範本或社群元件開始。然後,您可以選擇將文件打包為 ZIP 存檔的構建系統,使用 Maven 或 Gradle 構建腳本,或運行自定義構建命令。建立元件之後,您可以使用 GDK CLI 將其發佈到AWS IoT Greengrass服務,因此您可以使用AWS IoT Greengrass主控台或 API 將元件部署到 Greengrass 核心裝置。
當您在沒有 GDK CLI 的情況下開發 Greengrass 元件時,每次建立元件的新版本時,都必須更新元件方案檔案中的版本和成品 URI。當您使用 GDK CLI 時,它可以在您每次發佈新版本的元件時為您自動更新版本和成品 URI。
GDK CLI 是開放原始碼的,可在上 GitHub使用。您可以自訂和擴充 GDK CLI,以滿足您的元件開發需求。我們邀請您在 GitHub 存儲庫上打開問題並提取請求。您可以通過以下鏈接找到 GDK CLI 源代碼:https://github.com/aws-greengrass/ aws-greengrass-gdk-cli
必要條件
要安裝和使用 Greengrass 開發工具包 CLI,您需要以下內容:
-
AWS 帳戶。如果您沒有帳戶,請參閱 設定 AWS 帳戶。
-
具有網際網路連線的視窗、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和解除安裝〉和〈設定〉。
注意
如果您使用樹莓派或其他 32 位 ARM 設備,請安裝 AWS CLI V1。 AWS CLIV2 不適用於 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 每個版本中的變更。如需詳細資訊,請參閱上的 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 |
初始版本。 |