本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
安装 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 组件部署到您的核心设备:
-
在导航菜单中,选择组件。
-
在组件页面,在公共组件选项卡,选择
aws.greengrass.Cli
。 -
在aws.greengrass.Cli页面,选择部署。
-
来自添加到部署,选择创建新部署。
-
在指定目标页面,下方部署目标,在目标名称列表,选择要部署到的 Greengrass 组,然后选择下一步。
-
在选择组件页面,验证aws.greengrass.Cli组件被选中,然后选择下一步。
-
在配置组件页面,保留默认配置设置,然后选择下一步。
-
在配置高级设置页面,保留默认配置设置,然后选择下一步。
-
在点评页面,单击部署
-
在您的设备上,创建
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
字段,替换
使用部署目标事物或事物组的 Amazon 资源名称 (ARN),格式如下: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 作为 root 用户 (
sudo
) 或者以运行的系统用户身份Amazon IoT Greengrass核心软件。 configurationUpdate.AuthorizedWindowsGroups
-
(可选)包含以逗号分隔的系统组列表的字符串。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件。您可以指定群组名称或群组 ID。例如,
group1,1002,group3
授权三个系统组 (group1
,1002
,以及group3
) 使用 Greengrass CLI。如果您未指定任何组进行授权,则可以以管理员或运行的系统用户身份使用 Greengrass CLIAmazon IoT Greengrass核心软件。
-
-
运行以下命令在设备上部署 Greengrass CLI 组件:
$
aws greengrassv2 create-deployment --cli-input-json file://path/to/
deployment.json
在安装过程中,该组件将符号链接添加到greengrass-cli
在
设备上的文件夹,然后从这个路径运行 Greengrass CLI。要在没有绝对路径的情况下运行 Greengrass CLI,请添加你的/greengrass/v2
/bin
文件夹到你的 PATH 变量。要验证 Greengrass CLI 的安装,请运行以下命令:/greengrass/v2
/bin
您应看到以下输出:
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 的故障。