安装 Greengrass CLI - Amazon IoT Greengrass
Prerequisites部署 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.

Prerequisites

您必须满足以下要求才能部署 Greengrass CLI 组件：

  • Amazon IoT Greengrass核心设备上安装和配置的核心软件。有关更多信息，请参阅开始使用 Amazon IoT Greengrass V2。

  • 使用Amazon CLI，您必须安装并配置Amazon CLI在您的 Linux 设备上。有关更多信息，请参阅 Amazon CLI 用户指南 中的配置 Amazon Command Line Interface。

部署 Greengrass CLI 组件后，您必须以授权用户身份运行 Greengrass CLI，以便与Amazon IoT Greengrass核心软件。您可以以下列某个用户身份运行：

  • root 用户 (sudo)。

  • 系统用户运行Amazon IoT Greengrass核心软件。

  • 授权系统组中的系统用户。您可以使用AuthorizedPosixGroups配置参数，当您部署 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.4.0",
      "configurationUpdate": {
        "AuthorizedPosixGroups": "<group1>,<group2>,...,<groupN>"
      }
    }
  }
}

    • 在target字段，替换targetArn，格式如下：

      • 事物：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"授权三个系统组（group1、1002, 和group3）以使用 Greengrass CLI。

      如果您没有指定任何要授权的组，则可以使用 Greengrass CLI 作为根用户 (sudo），或者作为运行Amazon 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.

如果greengrass-cli，则部署可能无法安装 Greengrass CLI。有关更多信息，请参阅Troubleshooting。