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

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

安裝 Greengrass CLI

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

  • 首次在裝置上設定 AWS IoT Greengrass Core 軟體時，請使用--deploy-dev-tools引數。您也必須指--provision true定套用此引數。

  • 在您的設備上部署綠色CLI組件（aws.greengrass.Cli）。

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

必要條件

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

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

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

  • 您必須獲得授權才能使用 Greengrass 與核心軟體CLI進行互動 AWS IoT Greengrass 。請執行下列其中一項作業以使用 GreengrassCLI：

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

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

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

部署 Greeng CLI rass 元件

完成下列步驟，即可將 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檔案以定義 Greengr CLI ass 元件的部署組態。此檔案看起來應如下所示：

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

    • 在target欄位中，以targetArn下列格式將物件或物群組的 Amazon 資源名稱 (ARN) 取代為目標，以下列格式：

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

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

    • 在aws.greengrass.Cli組件物件中，依下列方式指定值：

      version

      Greengr CLI ass 組件的版本。

      configurationUpdate.AuthorizedPosixGroups

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

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

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

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

在安裝期間，元件會在裝置上的/greengrass/v2/bin資料夾greengrass-cli中新增符號連結，然後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不到，則部署可能無法安裝 Greeng CLI rass。如需詳細資訊，請參閱疑難排 AWS IoT Greengrass V2。