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

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

安装 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 GreengrassCore 软件。执行以下操作之一以使用 Greengrass CLI：

    • 使用运行Amazon IoT GreengrassCore 软件。

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

    • 使用位于组中的系统用户，该用户在AuthorizedPosixGroups要么AuthorizedWindowsGroups部署组件时的配置参数。有关更多信息，请参阅 。Greengrass CLI 组件配置.

部署 Greengrass CLI 组件

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

  1. 登录到 Amazon IoT Greengrass 控制台。

  2. 在导航菜单中，选择组件.

  3. 在存储库的组件在页面上，公共组件选项卡上，选择aws.greengrass.Cli.

  4. 在存储库的aws.greengrass.Cli在页面上，选择部署.

  5. 从添加到部署，选择创建新部署.

  6. 在存储库的指定目标页面，下部署目标，在Target name列表中，选择要将部署到的 Greengrass 组，然后选择下一步.

  7. 在存储库的选择组件页面中，验证aws.greengrass.Cli已选择组件，然后选择下一步.

  8. 在存储库的配置组件页面上，保留默认配置设置，然后选择下一步.

  9. 在存储库的配置高级设置页面上，保留默认配置设置，然后选择下一步.

  10. 在存储库的审核在页面上，单击部署

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

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.5.6",
      "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 GreengrassCore 软件。您可以指定组名称或群组 ID。例如，group1,1002,group3授权三个系统组（group1、1002, 和group3) 以使用 Greengrass CLI。

      如果您没有指定要授权的任何组，则可以使用 Greengrass CLI 作为根用户（sudo) 或者作为运行Amazon IoT GreengrassCore 软件。

      configurationUpdate.AuthorizedWindowsGroups

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

      如果您没有指定要授权的任何组，则可以将 Greengrass CLI 用作管理员或运行Amazon IoT GreengrassCore 软件。

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