本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
创建子部署
注意
子部署功能适用于 Greengrass Nucleus 版本 2.9.0 及更高版本。Greengrass Nucleus 的早期组件版本无法将配置部署到子部署中。
子部署是针对父部署中较小设备子集的部署。您可以使用子部署将配置部署到较小的设备子集中。您还可以创建子部署,在父部署中的一台或多台设备失败时来重试不成功的父部署。借助此功能,您可以选择在父部署中失败的设备,然后创建一个子部署来测试配置,直到子部署成功。子部署成功后,您可以将该配置重新部署到父部署。
按照本节中的步骤操作,创建子部署并检查其状态。有关如何创建部署的更多信息,请参阅创建部署。
创建子部署(Amazon CLI)
-
运行以下命令以检索事物组的最新部署。将命令中的 ARN 替换为要查询的事物组的 ARN。将
设置为--history-filter
LATEST_ONLY
,查看该事物组的最新部署。aws greengrassv2 list-deployments
--target-arn
arn:aws:iot:region
:account-id
:thinggroup/thingGroupName
--history-filter
LATEST_ONLY
-
将响应中的
deploymentId
复制到 list-deployments 命令,以便在下一步中使用。 -
运行以下命令以检索部署的状态。将
替换为要查询的部署的 ID。deploymentId
aws greengrassv2 get-deployment
--deployment-id
deploymentId
-
将响应中的
iotJobId
复制到 get-deployment 命令中,以便在接下来的步骤中使用。 -
运行以下命令以检索指定作业的作业执行列表。将
jobID
替换为上一步中的iotJobId
。将status
替换为您要筛选的状态。您可以根据以下状态筛选结果:-
QUEUED
-
IN_PROGRESS
-
SUCCEEDED
-
FAILED
-
TIMED_OUT
-
REJECTED
-
REMOVED
-
CANCELED
aws iot list-job-executions-for-job
--job-id
jobID
--status
status
-
-
为子部署创建新的 Amazon IoT 事物组或使用现有事物组。然后,向该事物组中添加一个 Amazon IoT 事物。您可以使用事物组来管理 Greengrass 核心设备实例集。将软件组件部署到设备时,可以将单个设备或设备组设为目标。您可以通过激活的 Greengrass 部署将设备添加到事物组。添加后,您可以将该事物组的软件组件部署到该设备上。
要创建新的事物组并将您的设备添加到其中,请执行以下操作:
-
创建 Amazon IoT 事物组。将
MyGreengrassCoreGroup
替换为新事物组的名称。请勿在事物组名称中使用半角冒号(:)。注意
如果将子部署的某个事物组用于一个
parentTargetArn
,则无法在其他父实例集中重复使用该事物组。如果事物组已被用于为另一个实例集创建子部署,则 API 将返回错误。aws iot create-thing-group
--thing-group-name
MyGreengrassCoreGroup
如果请求成功,将返回与以下示例类似的响应:
{ "thingGroupName": "MyGreengrassCoreGroup", "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/
MyGreengrassCoreGroup
", "thingGroupId": "4df721e1-ff9f-4f97-92dd-02db4e3f03aa" } -
将已预置的 Greengrass Nucleus 添加到您的事物组中。使用这些参数运行以下命令:
-
将
MyGreengrassCore
替换为已预置的 Greengrass Nucleus 的名称。 -
将
MyGreengrassCoreGroup
替换为您的事物组的名称。
aws iot add-thing-to-thing-group
--thing-name
MyGreengrassCore
--thing-group-name
MyGreengrassCoreGroup
如果请求成功,则该命令没有任何输出。
-
-
-
创建一个名为
deployment.json
的文件,然后将以下 JSON 对象复制到该文件中。将targetArn
替换为 Amazon IoT 事物组的 ARN,作为子部署目标。子部署目标只能是事物组。事物组 ARN 采用以下格式:-
事物组 –
arn:aws:iot:
region
:account-id
:thinggroup/thingGroupName
{ "targetArn": "
targetArn
" } -
-
再次运行以下命令,获取原始部署的详细信息。这些详细信息包括元数据、组件和作业配置。将
deploymentId
替换为 步骤 1 中的 ID。您可以使用此部署配置来配置您的子部署,并根据需要进行更改。aws greengrassv2 get-deployment
--deployment-id
deploymentId
响应包含部署的详细信息。从 get-deployment 命令的响应中,将以下任何键值对复制到
deployment.json
中。您可以为子部署更改这些值。有关此命令的更多详细信息,请参阅 GetDeployment。-
components
– 部署的组件。要卸载组件,请将其从该对象中移除。 -
deploymentName
– 部署的名称。 -
deploymentPolicies
– 部署的策略。 -
iotJobConfiguration
– 部署的作业配置。 -
parentTargetArn
– 父部署的目标。 -
tags
– 部署的标签。
-
-
运行以下命令,从
deployment.json
创建子部署。将subdeploymentName
替换为子部署的名称。aws greengrassv2 create-deployment
--deployment-name
subdeploymentName
--cli-input-json
file://deployment.json响应中包含标识此子部署的
deploymentId
。您可以使用部署 ID 来检查部署的状态。有关更多信息,请参阅检查部署状态。 -
如果子部署成功,则可以使用其配置来修改父部署。复制在上一步中使用的
deployment.json
。将 JSON 文件中的targetArn
替换为父部署的 ARN,然后运行以下命令,使用此新配置创建父部署。注意
如果您创建父实例集的新部署修订版,它将替换该父部署的所有部署修订版和子部署。有关更多信息,请参阅修改部署。
aws greengrassv2 create-deployment
--cli-input-json
file://deployment.json响应中包含用于标识此部署的
deploymentId
。您可以使用部署 ID 来检查部署的状态。有关更多信息,请参阅 检查部署状态。