安装 Greengrass CLI - AWS IoT Greengrass
Prerequisites部署 Greengrass CLI 组件
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

安装 Greengrass CLI

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

  • 当您首次在设备上设置 AWS AWS IoT Greengrass 核心软件时，请使用 --deploy-dev-tools 参数。

  • 在设备上部署 Greengrass CLI 组件 （aws.greengrass.Cli）。

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

Prerequisites

您必须满足以下要求才能部署 Greengrass CLI 组件：

  • AWS AWS IoT Greengrass 核心软件在您的核心设备上安装和配置。有关更多信息，请参阅AWS AWS IoT Greengrass V2 入门。

  • 要使用 AWS CLI 部署 Greengrass CLI，您必须在 Linux 设备上安装和配置 AWS CLI。有关更多信息，请参阅 AWS 命令行界面用户指南中的配置 AWS CLI。

部署 Greengrass CLI 组件后，您必须以授权用户身份运行 Greengrass CLI 以与 AWS AWS IoT Greengrass 核心软件交互。您可以作为以下用户之一运行它：

  • 根用户 （sudo）。

  • 运行 AWS IoT IoT Greengrass 核心软件的系统用户。

  • 授权系统组中的系统用户。在部署 Greengrass CLI 组件以对系统组进行授权时，您可以使用 AuthorizedPosixGroups 配置参数。

部署 Greengrass CLI 组件

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

  1. 登录 AWS AWS IoT Greengrass 控制台。

  2. 在导航菜单中，选择 Components （组件）。

  3. 在 Components （组件） 页面上的 Public components （公有组件） 选项卡上，选择 aws.greengrass.Cli。

  4. 在 aws.greengrass.Cli 页面上，选择 Deploy （部署）。

  5. 从 Add to deployment （添加到部署） 中，选择 Create new deployment （创建新部署）。

  6. 在 Specify target （指定目标） 页面的 Deployment targets （部署目标） 下，在 Target name （目标名称） 列表中，选择要部署到的 Greengrass 组，然后选择 Next （下一步）。

  7. 在 Select components （选择组件） 页面上，验证选择了aws.greengrass.Cli组件，然后选择 Next （下一步）。

  8. 在 Configure components （配置组件） 页面上，保留默认配置设置，然后选择 Next （下一步）。

  9. 在 Configure advanced setting （配置高级设置） 页面上，保留默认配置设置，然后选择 Next （下一步）。

  10. 在 Review （审核） 页面上，单击 Deploy （部署）

  1. 在您的设备上，创建一个 deployment.json 文件来定义 Greengrass CLI 组件的部署配置。此文件应与以下内容类似： 

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.0.5",
      "configurationUpdate": {
        "AuthorizedPosixGroups": "<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 与 AWS AWS IoT Greengrass 核心软件交互的系统组的逗号分隔列表。您可以指定组名称或组 IDs。例如，指定 "group1,1002,group3" 会授权三个系统组group11002（、 和 group3）使用 Greengrass CLI。

      如果未指定要授权的任何组，您可以使用 Greengrass CLI 作为根用户 （sudo） 或运行 AWS AWS IoT Greengrass 核心软件的系统用户。

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

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

在安装过程中， 组件将符号链接添加到您设备上的 greengrass-cli /greengrass/v2/bin 文件夹中的 ，并且您从该路径运行 Greengrass CLI。要在没有绝对路径的情况下运行 Greengrass CLI，请将您的/greengrass/v2/bin文件夹添加到您的 PATH 变量中。要验证 Greengrass CLI 安装，请运行以下命令： 

$ /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.