安装 Greengrass CLI - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

安装 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,请执行以下某种操作:

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

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

    • 使用您在部署组件时在AuthorizedPosixGroupsAuthorizedWindowsGroups配置参数中指定的组中的系统用户。有关更多信息,请参阅 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.9.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

      Greengrass CLI 组件版本。

      configurationUpdate.AuthorizedPosixGroups

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

      如果您未指定任何要授权的组,则可以将 Greengrass CLI 用作根用户 (sudo) 或运行Amazon IoT Greengrass核心软件的系统用户。

      configurationUpdate.AuthorizedWindowsGroups

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

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

  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 的故障