安装 Greengrass CLI - Amazon IoT Greengrass
先决条件部署 Greengrass CLI 组件
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

安装 Greengrass CLI

你可以通过以下方式之一安装 Greengrass CLI：

  • 首次在设备上设置 Amazon IoT Greengrass Core 软件时，请使用该--deploy-dev-tools参数。您还必须指定--provision true才能应用此参数。

  • 在您的设备上部署 Greengrass CLI 组件 aws.greengrass.Cli ()。

本节介绍部署 Greengrass CLI 组件的步骤。有关在初始设置期间安装 Greengrass CLI 的信息，请参阅。教程：Amazon IoT Greengrass V2 入门

先决条件

要部署 Greengrass CLI 组件，必须满足以下要求：

  • Amazon IoT Greengrass 在您的核心设备上安装并配置了核心软件。有关更多信息，请参阅教程：Amazon IoT Greengrass V2 入门。

  • 要使用部 Amazon CLI 署 Greengrass CLI，您必须已安装并配置了。 Amazon CLI有关更多信息，请参阅《Amazon Command Line Interface 用户指南》中的配置 Amazon CLI。

  • 您必须获得授权才能使用 Greengrass CLI 与核心软件进行交互。 Amazon IoT Greengrass 要使用 Greengrass CLI，请执行以下任一操作：

    • 使用运行 C Amazon IoT Greengrass ore 软件的系统用户。

    • 使用具有 root 权限或管理员权限的用户。在 Linux 核心设备上sudo，您可以使用获取根权限。

    • 部署组件时，请使用您在AuthorizedPosixGroups或AuthorizedWindowsGroups配置参数中指定的组中的系统用户。有关更多信息，请参阅 Greengrass CLI 组件配置。

部署 Greengrass CLI 组件

完成以下步骤，将 Greengrass CLI 组件部署到您的核心设备：

  1. 登录 Amazon 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.12.2",
      "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

      Greengrass CLI 组件的版本。

      configurationUpdate.AuthorizedPosixGroups

      （可选）包含以逗号分隔的系统组列表的字符串。您授权这些系统组使用 Greengrass CLI 与核心软件进行交互。 Amazon IoT Greengrass 您可以指定群组名称或群组 ID。例如，group1,1002,group3授权三个系统组（group11002、和group3）使用 Greengrass CLI。

      如果您未指定要授权的任何群组，则可以以 root 用户 sudo () 或运行核心软件的系统用户身份使用 Greengrass CLI。 Amazon IoT Greengrass

      configurationUpdate.AuthorizedWindowsGroups

      （可选）包含以逗号分隔的系统组列表的字符串。您授权这些系统组使用 Greengrass CLI 与核心软件进行交互。 Amazon IoT Greengrass 您可以指定群组名称或群组 ID。例如，group1,1002,group3授权三个系统组（group11002、和group3）使用 Greengrass CLI。

      如果您未指定要授权的任何群组，则可以以管理员或运行 Core 软件的系统用户身份使用 Greengrass CLI。 Amazon IoT Greengrass

  2. 运行以下命令在设备上部署 Greengrass CLI 组件：

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

在安装过程中，该组件会在设备上的/greengrass/v2/bin文件夹greengrass-cli中添加一个符号链接，然后您可以从此路径运行 Greengrass CLI。要在没有绝对路径的情况下运行 Greengrass CLI，/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。有关更多信息，请参阅 故障排除 Amazon IoT Greengrass V2。