Greengrass

Greengrass CLI 元件 (aws.greengrass.Cli) 提供本機命令列介面，您可以在核心裝置上使用此介面，在本機開發和偵錯元件。例如，Greengrass CLI 可讓您建立本機部署，並重新啟動核心裝置上的元件。

您可以在安裝 AWS IoT Greengrass Core 軟體時安裝此元件。如需詳細資訊，請參閱教學課程：AWS IoT Greengrass V2 入門。

重要

我們建議您僅在開發環境中使用此元件，而不是在生產環境中使用。此元件可讓您存取通常在生產環境中不需要的資訊和作業。只將此元件部署到您需要的核心裝置，以遵循最低權限原則。

安裝此元件之後，請執行下列命令以檢視其說明文件。安裝此組件時，它會在文件/greengrass/v2/bin夾greengrass-cli中添加一個符號鏈接。您可以從此路徑運行 Greengrass CLI，或將其添加到PATH環境變量中以在沒有絕對路徑的greengrass-cli情況下運行。

例如com.example.HelloWorld，下列指令會重新啟動名為的元件。

如需詳細資訊，請參閱綠色命令行界面。

版本

此元件具有下列版本：

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

Type

這個組件是一個插件組件（aws.greengrass.plugin）。Greengrass 核在與核相同的 Java 虛擬機（JVM）中運行此組件。當您在核心裝置上變更此元件的版本時，核心會重新啟動。

此組件使用與 Greengrass 核相同的日誌文件。如需詳細資訊，請參閱監控AWS IoT Greengrass日誌。

如需詳細資訊，請參閱元件類型。

作業系統

此元件可安裝在執行下列作業系統的核心裝置上：

Linux
Windows

要求

此元件具有下列需求：

您必須獲得授權才能使用 Greengrass CLI 與核心軟體進行互動 AWS IoT Greengrass 。執行下列其中一項動作以使用 Greengrass CLI：
- 使用執行 AWS IoT Greengrass Core 軟體的系統使用者。
- 使用具有 root 權限或管理權限的使用者。在 Linux 核心裝置上，您可以使用sudo來取得根權限。
- 部署元件時，請使用位於AuthorizedPosixGroups或組AuthorizedWindowsGroups態參數中指定之群組中的系統使用者。如需詳細資訊，請參閱 Greengrass CLI 元件組態。
支援在虛擬私人雲端中執行的 CLI Greengrass 件。

相依性

部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求，才能成功部署元件。本節列出此元件之已發行版本的相依性，以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass 主控台中檢視元件每個版本的相依性。在元件詳細資料頁面上，尋找 [相依性] 清單。

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.12.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	>=2.11.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.5.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.5.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.5.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.5.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.5.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	>=2.5.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.1.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.1.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.1.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.1.0	軟式

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.0.0	軟式

如需有關元件相依性的詳細資訊，請參閱元件方案參考。

組態

此元件提供下列組態參數，您可以在部署元件時自訂這些參數。

2.5.x - 2.12.x

AuthorizedPosixGroups

(選擇性) 包含以逗號分隔的系統群組清單的字串。您授權這些系統群組使用 Greengrass CLI 與核心軟體互動。 AWS IoT Greengrass 您可以指定群組名稱或群組 ID。例如，group1,1002,group3授權三個系統群組 (group11002、和group3) 使用 Greengrass CLI。

如果您沒有指定任何要授權的群組，您可以使用 Greengrass CLI 做為根使用者 (sudo) 或執行 Core 軟體的系統使用者。 AWS IoT Greengrass

AuthorizedWindowsGroups

如果您未指定任何要授權的群組，您可以使用 Greengrass CLI 做為系統管理員或執行 Core 軟體的系統使用者。 AWS IoT Greengrass

範例：組態合併更新

下列範例組態指定要授權三個 POSIX 系統群組 (group11002、和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 做為根使用者 (sudo) 或執行 Core 軟體的系統使用者。 AWS IoT Greengrass

範例：組態合併更新

下列範例組態指定要授權三個系統群組 (group11002、和group3) 使用 Greengrass CLI。


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

本機記錄檔

此元件使用與 Greengrass 核元件相同的記錄檔。

若要檢視此元件的記錄

在核心裝置上執行下列命令，即時檢視此元件的記錄檔。以 AWS IoT Greengrass 根資料夾的路徑取代/greengrass/v2或 C:\greengrass\v2。
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

變更記錄

下表說明元件每個版本的變更。

版本	變更
2.12.6	版本更新 Greengrass 2.12.6 版本的版本。
2.12.5	版本更新 Greengrass 2.12.5 版本的版本。
2.12.4	版本更新了 Greengrass 核 2.12.4 版本。
2.12.3	警告此版本已不再提供。此版本中的改進功能在此元件的更新版本中提供。版本更新 Greengrass 2.12.3 版本的版本。
2.12.2	版本更新 Greengrass 2.12.2 版本的版本。
2.12.1	版本更新 Greengrass 2.12.1 版本的版本。
2.12.0	版本更新 Greengrass 2.12.0 版本釋放。
2.11.3	版本更新 Greengrass 2.11.3 版本釋放。
2.11.2	版本更新 Greengrass 2.11.2 版本發布。
2.11.1	版本更新 Greengrass 2.11.1 版本的版本。
2.11.0	新功能可讓您取消本機部署。可讓您設定本機部署的失敗處理原則。改進了詳細的部署狀態報告。
2.10.3	版本更新 Greengrass 2.10.3 版本的版本。
2.10.2	版本更新 Greengrass 2.10.2 版本的版本。
2.10.1	版本更新 Greengrass 2.10.1 版本的版本。
2.10.0	版本更新了 Greengrass 2.10.0 版本。
2.9.6	版本更新 Greengrass 2.9.6 版本的版本。
2.9.5	版本更新了 Greengrass 核 2.9.5 版本發布。
2.9.4	版本更新 Greengrass 2.9.4 版本的版本。
2.9.3	版本更新 Greengrass 2.9.3 版本的版本。
2.9.2	版本更新 Greengrass 2.9.2 版本的版本。
2.9.1	版本更新 Greengrass 2.9.1 版本的版本。
2.9.0	版本更新 Greengrass 2.9.0 版本釋放。
2.8.1	版本更新 Greengrass 2.8.1 版本的版本。
2.8.0	版本更新 Greengrass 2.8.0 版本的版本。
2.7.0	版本更新了 Greengrass 核 2.7.0 版本釋放。
2.6.0	新功能添加對自定義組件的支持，以調用 Greengrass CLI 使用的進程間通信（IPC）操作。您可以使用這些 IPC 作業來管理本機部署、檢視元件詳細資料，以及產生可用來登入本機除錯主控台的密碼。如需詳細資訊，請參閱 IPC：管理本機部署和元件。錯誤修復和改進其他小的修正和改進。
2.5.6	版本更新 Greengrass 2.5.6 版本發布。
2.5.5	版本更新 Greengrass 2.5.5 版本的版本。
2.5.4	版本更新 Greengrass 2.5.4 版本發布。
2.5.3	版本更新 Greengrass 2.5.3 版本的版本。
2.5.2	版本更新 Greengrass 2.5.2 版本的版本。
2.5.1	版本更新了 Greengrass 核 2.5.1 版本。
2.5.0	新功能添加對運行 Windows 的核心設備的支持。新增可指定的新組`AuthorizedWindowsGroups`態參數，以授權系統群組在 Windows 裝置上使用 Greengrass CLI。為本機部署新增`windowsUser`參數。您可以使用此參數指定用來在 Windows 核心裝置上執行元件的使用者。
2.4.0	新功能添加對系統資源限制的支援。當您建立本機部署時，您可以設定每個元件的處理序可在核心裝置上使用的 CPU 和 RAM 使用量上限。若要取得更多資訊，請參閱設定元件的系統資源限制和部署建立指令。
2.3.0	版本更新了 Greengrass 核 2.3.0 版本。
2.2.0	版本更新了 Greengrass 核 2.2.0 版本。
2.1.0	版本更新 Greengrass 2.1.0 版本發布。
2.0.5	版本更新了 Greengrass 核 2.0.5 版本。
2.0.4	版本更新 Greengrass 2.0.4 版本的版本。
2.0.3	初始版本。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Kinesis Video Streams 的邊緣連接器

IP 偵測器

Greengrass

重要

主題

版本

Type

作業系統

要求

相依性

注意

組態

範例：組態合併更新

範例：組態合併更新

本機記錄檔

若要檢視此元件的記錄

變更記錄

警告