Greengrass CLI - AWS IoT Greengrass
版本Type作業系統要求相依性組態本機記錄檔變更記錄

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Greengrass CLI

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

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

重要

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

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

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

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

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

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

版本

此元件具有下列版本：

  • 2.13.x

  • 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 。請執行下列其中一項作業以使用 GreengrassCLI：

    • 使用執行 AWS IoT Greengrass Core 軟體的系統使用者。

    • 使用具有 root 權限或管理權限的使用者。在 Linux 核心裝置上，您可以使用sudo來取得根權限。

    • 部署元件時，請使用位於AuthorizedPosixGroups或組AuthorizedWindowsGroups態參數中指定之群組中的系統使用者。如需詳細資訊，請參閱 Greengrass CLI 元件組態。

  • 支CLI援在. VPC

相依性

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

2.13.0

下表列出此元件 2.12.0 到 2.14.0 版的相依性。

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

下表列出此元件 2.12.0 到 2.12.6 版的相依性。

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

下表列出此元件 2.11.0 到 2.11.3 版的相依性。

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

下表列出此元件 2.10.0 到 2.10.3 版的相依性。

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

下表列出此元件 2.9.0 到 2.9.6 版的相依性。

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

下表列出此元件 2.8.0 和 2.8.1 版的相依性。

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

下表列出此元件 2.7.0 版的相依性。

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

下表列出此元件 2.6.0 版的相依性。

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

下表列出此元件 2.5.0 到 2.5.6 版的相依性。

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

下表列出此元件 2.4.0 版的相依性。

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

下表列出此元件 2.3.0 版的相依性。

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

下表列出此元件 2.2.0 版的相依性。

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

下表列出此元件 2.1.0 版的相依性。

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

下表列出此元件 2.0.x 版的相依性。

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

Greengrass 核的最低相容版本對應於 Greengrass 元件的修補程式版本。CLI

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

組態

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

2.5.x - 2.12.x
AuthorizedPosixGroups

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

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

AuthorizedWindowsGroups

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

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

範例：組態合併更新

下列範例組態指定要授權三個POSIX系統群組 (group11002、和group3) 和兩個 Windows 使用者群組 (Device Operators和QA Engineers) 來使用 Greeng CLI rass。

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
2.4.x - 2.0.x
AuthorizedPosixGroups

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

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

範例：組態合併更新

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

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

本機記錄檔

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

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
若要檢視此元件的記錄

  • 在核心裝置上執行下列命令，即時檢視此元件的記錄檔。更換/greengrass/v2或 C:\greengrass\v2 與 AWS IoT Greengrass 根文件夾的路徑。

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

變更記錄

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

版本

變更

2.13.0

版本更新了 Greengrass 2.13.0 版本。

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
新功能

  • 添加對自定義組件的支持，以調用 Greeng CLI rass 使用的進程間通信（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 設備CLI上使用 Greengrass。

  • 為本機部署新增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

初始版本。