本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
安装 Greengrass CLI
你可以通过以下方式之一安装 Greengrass CLI:
-
首次在设备上设置 Amazon IoT Greengrass Core 软件时,请使用该
--deploy-dev-tools
参数。您还必须指定--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,请执行以下任一操作:
-
使用运行 C Amazon IoT Greengrass ore 软件的系统用户。
-
使用具有 root 权限或管理员权限的用户。在 Linux 核心设备上
sudo
,您可以使用获取根权限。 -
部署组件时,请使用您在
AuthorizedPosixGroups
或AuthorizedWindowsGroups
配置参数中指定的组中的系统用户。有关更多信息,请参阅 Greengrass CLI 组件配置。
-
部署 Greengrass 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.12.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。如果您未指定要授权的任何群组,则可以以 root 用户
sudo
() 或运行核心软件的系统用户身份使用 Greengrass CLI。 Amazon IoT Greengrass configurationUpdate.AuthorizedWindowsGroups
-
(可选)包含以逗号分隔的系统组列表的字符串。您授权这些系统组使用 Greengrass CLI 与核心软件进行交互。 Amazon IoT Greengrass 您可以指定群组名称或群组 ID。例如,
group1,1002,group3
授权三个系统组(group1
1002
、和group3
)使用 Greengrass CLI。如果您未指定要授权的任何群组,则可以以管理员或运行 Core 软件的系统用户身份使用 Greengrass CLI。 Amazon IoT Greengrass
-
-
运行以下命令在设备上部署 Greengrass CLI 组件:
$
aws greengrassv2 create-deployment --cli-input-json file://path/to/
deployment.json
在安装过程中,该组件会在设备上的
文件夹
/bin/greengrass/v2
greengrass-cli
中添加一个符号链接,然后您可以从此路径运行 Greengrass CLI。要在没有绝对路径的情况下运行 Greengrass CLI,
请将您的文件夹添加到 PATH 变量中。要验证 Greengrass CLI 的安装,请运行以下命令:
/bin/greengrass/v2
您应看到以下输出:
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。