安装 Greengrass CLI - AWS IoT Greengrass
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.