安裝 Greengrass CLI - AWS IoT Greengrass
必要條件部署 Greengrass CLI元件

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

安裝 Greengrass CLI

您可以使用下列CLI其中一種方式安裝 Greengrass：

  • 當您第一次在裝置上設定 AWS IoT Greengrass 核心軟體時，請使用 --deploy-dev-tools引數。您也必須指定 --provision true才能套用此引數。

  • 在裝置上部署 Greengrass CLI元件 (aws.greengrass.Cli)。

本節說明部署 Greengrass CLI元件的步驟。如需在初始設定CLI期間安裝 Greengrass 的資訊，請參閱 教學課程：入門 AWS IoT Greengrass V2。

必要條件

若要部署 Greengrass CLI元件，您必須符合下列要求：

  • AWS IoT Greengrass 核心軟體已安裝並設定於您的核心裝置上。如需詳細資訊，請參閱教學課程：入門 AWS IoT Greengrass V2。

  • 若要使用 AWS CLI 部署 Greengrass CLI，您必須已安裝並設定 AWS CLI。如需詳細資訊，請參閱《AWS Command Line Interface 使用者指南》中的設定 AWS CLI。

  • 您必須獲得使用 Greengrass 與 AWS IoT Greengrass Core 軟體CLI互動的授權。執行下列其中一項操作以使用 GreengrassCLI：

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

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

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

部署 Greengrass CLI元件

完成下列步驟，將 Greengrass CLI元件部署到您的核心裝置：

  1. 登入 AWS IoT Greengrass 主控台。

  2. 在導覽功能表中，選擇元件。

  3. 在元面頁面上的公用元件索引標籤上，選擇 aws.greengrass.Cli。

  4. 在 上 aws.greengrass.Cli 頁面，選擇部署。

  5. 從新增至部署，選擇建立新部署。

  6. 在指定目標頁面的部署目標下，在目標名稱清單中，選擇您要部署的 Greengrass 群組，然後選擇下一步。

  7. 在選取元件頁面上，驗證 aws.greengrass.Cli 元件已選取，然後選擇下一步。

  8. 在設定元件頁面上，保留預設組態設定，然後選擇下一步。

  9. 在設定進階設定頁面上，保留預設組態設定，然後選擇下一步。

  10. 在檢閱頁面上，按一下部署

  1. 在您的裝置上，建立 deployment.json 檔案以定義 Greengrass CLI元件的部署組態。此檔案看起來應該如下所示：

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • 在 target 欄位中，將 targetArn取代為部署目標的物件或物件群組的 Amazon Resource Name (ARN)，格式如下：

      • 物件：arn:aws:iot:region:account-id:thing/thingName

      • 物件群組：arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • 在aws.greengrass.Cli元件物件中，指定值，如下所示：

      version

      Greengrass CLI元件的版本。

      configurationUpdate.AuthorizedPosixGroups

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

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

  2. 執行下列命令，在裝置上部署 Greengrass CLI元件：

    $ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json

在安裝期間，元件會在您裝置的 greengrass-cli /greengrass/v2/bin 資料夾中，將符號連結新增至 ，然後CLI您從此路徑執行 Greengrass。若要在沒有絕對路徑CLI的情況下執行 Greengrass，請將/greengrass/v2/bin資料夾新增至PATH變數。若要驗證 Greengrass CLI 安裝，請執行下列命令：

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

您應該會看到下列輸出：

Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
Greengrass command line interface

      --ggcRootPath=<ggcRootPath>
                  The AWS IoT Greengrass V2 root directory.
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.
Commands:
  help                Show help information for a command.
  component           Retrieve component information and stop or restart
                        components.
  deployment          Create local deployments and retrieve deployment status.
  logs                Analyze Greengrass logs.
  get-debug-password  Generate a password for use with the HTTP debug view
                        component.

如果greengrass-cli找不到 ，則部署可能無法安裝 Greengrass CLI。如需詳細資訊，請參閱故障診斷 AWS IoT Greengrass V2。