建立子部署

建立子部署 (AWS CLI)

1. 執行下列命令來擷取物件群組的最新部署。將命令中的 ARN 取代為要查詢之物件群組的 ARN。--history-filter 設定為 LATEST_ONLY以查看該物件群組的最新部署。

   aws greengrassv2 list-deployments --target-arn arn:aws:iot:region:account-id:thinggroup/thingGroupName --history-filter LATEST_ONLY

2. 將 deploymentId 從回應複製到 list-deployments命令，以在下一個步驟中使用。

3. 執行下列命令來擷取部署的狀態。deploymentId 將 取代為要查詢之部署的 ID。

   aws greengrassv2 get-deployment --deployment-id deploymentId

4. 將 iotJobId 從回應複製到 get-deployment命令，以在下列步驟中使用。

5. 執行下列命令，以擷取指定任務的任務執行清單。將 jobID 取代為上一個步驟iotJobId的 。將狀態取代為您要篩選的狀態。您可以篩選具有下列狀態的結果：

   • QUEUED

   • IN_PROGRESS

   • SUCCEEDED

   • FAILED

   • TIMED_OUT

   • REJECTED

   • REMOVED

   • CANCELED

   aws iot list-job-executions-for-job --job-id jobID --status status

6. 為您的子部署建立新的 AWS IoT 物件群組，或使用現有的物件群組。然後，將 AWS IoT 物件新增至此物件群組。您可以使用物件群組來管理 Greengrass 核心裝置的機群。當您將軟體元件部署到裝置時，您可以鎖定個別裝置或裝置群組。您可以將裝置新增至具有作用中 Greengrass 部署的物件群組。新增後，您就可以將該物件群組的軟體元件部署到該裝置。

   若要建立新的物件群組並將您的裝置新增至其中，請執行下列動作：

   1. 建立 AWS 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"
      }

   2. 將佈建的 Greengrass 核心新增至您的物件群組。使用這些參數執行下列命令：

      • 將 MyGreengrassCore 取代為您佈建的 Greengrass 核心的名稱。

      • 將 MyGreengrassCoreGroup 取代為您的物件群組名稱。

      aws iot add-thing-to-thing-group --thing-name MyGreengrassCore --thing-group-name MyGreengrassCoreGroup

      如果請求成功，命令不會有任何輸出。

7. 建立名為 的檔案deployment.json，然後將下列 JSON 物件複製到 檔案。將 targetArn 取代為 AWS IoT 物件群組的 ARN，以鎖定子部署的目標。子部署目標只能是物件群組。物件群組 ARNs的格式如下：

   • 物件群組 – arn:aws:iot:region:account-id:thinggroup/thingGroupName

   {
     "targetArn": "targetArn"
   }

8. 再次執行下列命令，以取得原始部署的詳細資訊。這些詳細資訊包括中繼資料、元件和任務組態。將 deploymentId 取代為來自 的 ID步驟 1。您可以使用此部署組態來設定子部署，並視需要進行變更。

   aws greengrassv2 get-deployment --deployment-id deploymentId

   回應包含部署的詳細資訊。將下列任一鍵值對從get-deployment命令的回應複製到 deployment.json。您可以變更子部署的這些值。如需此命令詳細資訊的詳細資訊，請參閱 GetDeployment。

   • components – 部署的元件。若要解除安裝元件，請從此物件中移除它。

   • deploymentName – 部署的名稱。

   • deploymentPolicies – 部署的政策。

   • iotJobConfiguration – 部署的任務組態。

   • parentTargetArn – 父系部署的目標。

   • tags – 部署的標籤。

9. 執行下列命令，從 建立子部署deployment.json。將 subdeploymentName 取代為子部署的名稱。

   aws greengrassv2 create-deployment --deployment-name subdeploymentName --cli-input-json file://deployment.json

   回應包含可識別此子部署deploymentId的 。您可以使用部署 ID 來檢查部署的狀態。如需詳細資訊，請參閱檢查部署狀態。

10. 如果子部署成功，您可以使用其組態來修改父部署。複製deployment.json您在上一個步驟中使用的 。targetArn 將 JSON 檔案中的 取代為父系部署的 ARN，並執行下列命令來使用此新組態建立父系部署。

    注意

    如果您建立新的父機群部署修訂版，它會取代該父部署的所有部署修訂版和子部署。如需詳細資訊，請參閱修訂部署。

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

    回應包含可識別此部署deploymentId的 。您可以使用部署 ID 來檢查部署的狀態。如需詳細資訊，請參閱檢查部署狀態。