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

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

安装 Greengrass CLI

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

  • 使用--deploy-dev-tools第一次设置时的争论Amazon IoT Greengrass设备上的核心软件。您还必须指定--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核心软件。

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

    • 使用您在中指定的群组中的系统用户AuthorizedPosixGroups要么AuthorizedWindowsGroups部署组件时的配置参数。有关更多信息,请参见格林格拉斯 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.11.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。

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

      configurationUpdate.AuthorizedWindowsGroups

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

      如果您未指定任何组进行授权,则可以以管理员或运行的系统用户身份使用 Greengrass CLIAmazon 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 的安装,请运行以下命令:

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