选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

安装 Greengrass CLI

聚焦模式
安装 Greengrass CLI - AWS IoT Greengrass

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

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

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

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

  • 在设备上部署 Greengrass CLI 组件(aws.greengrass.Cli)。

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

先决条件

要部署 Greengrass CLI 组件,必须满足以下要求:

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

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

  • 您必须获得授权才能使用 Greengrass CLI 与核心软件进行交互。 AWS IoT Greengrass 执行以下任一操作以使用 Greengrass CLI:

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

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

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

部署 Greengrass CLI 组件

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

  1. 登录 AWS IoT Greengrass 控制台

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

  3. 组件页面的公有组件选项卡上,选择 aws.greengrass.Cli

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

  5. 添加到部署中,选择创建新部署

  6. 指定目标页面的部署目标下找到目标名称列表,从中选择要部署到其中的 Greengrass 组,然后选择下一步

  7. “选择组件” 页面上,验证 aws.greengrass.Cli已选择组件,然后选择下一步

  8. 配置组件页面上,保留默认配置设置,然后选择下一步

  9. 配置高级设置页面上,保留默认配置设置,然后选择下一步

  10. 检查页上,点击部署

部署 Greengrass CLI 组件(控制台)

  1. 登录 AWS IoT Greengrass 控制台

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

  3. 组件页面的公有组件选项卡上,选择 aws.greengrass.Cli

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

  5. 添加到部署中,选择创建新部署

  6. 指定目标页面的部署目标下找到目标名称列表,从中选择要部署到其中的 Greengrass 组,然后选择下一步

  7. “选择组件” 页面上,验证 aws.greengrass.Cli已选择组件,然后选择下一步

  8. 配置组件页面上,保留默认配置设置,然后选择下一步

  9. 配置高级设置页面上,保留默认配置设置,然后选择下一步

  10. 检查页上,点击部署

  1. 在您的设备上,创建一个定义 Greengrass CLI 组件部署配置的 deployment.json 文件。此文件应类似以下内容:

    { "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

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

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

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

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

  1. 在您的设备上,创建一个定义 Greengrass CLI 组件部署配置的 deployment.json 文件。此文件应类似以下内容:

    { "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

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

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

      configurationUpdate.AuthorizedWindowsGroups

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

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

  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
/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。有关更多信息,请参阅 故障排除 AWS IoT Greengrass V2

本页内容

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。