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

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

安装 Greengrass CLI

你可以通过以下方式之一安装 G CLI reengrass:

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

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

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

先决条件

要部署 G CLI reengrass 组件,您必须满足以下要求:

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

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

  • 您必须获得授权才能使用 G CLI reengrass 与核心软件进行交互。 Amazon IoT Greengrass 要使用 Greengr CLI ass,请执行以下操作之一:

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

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

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

部署 Greengrass 组件 CLI

完成以下步骤,将 G CLI reengrass 组件部署到您的核心设备:

  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.14.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

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

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

  2. 运行以下命令在设备上部署 G CLI reengrass 组件:

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

在安装过程中,该组件会在设备上的/greengrass/v2/bin文件夹greengrass-cli中添加一个符号链接,然后您可以从此路径运行 G CLI reengrass。要在没有绝对路径的情况下运行 CLI Greengrass,请将您的文件夹添加到/greengrass/v2/bin变量中。PATH要验证 G CLI reengrass 的安装,请运行以下命令:

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未找到,则部署可能无法安装 Greengr CLI ass。有关更多信息,请参阅 故障排除 Amazon IoT Greengrass V2