重設部署 - AWS IoT Greengrass

若我們提供該指南英語版本的翻譯,在有任何牴觸的狀況下請以英文版本的指南為主。其透過機器翻譯提供翻譯。

重設部署

只有 AWS IoT Greengrass Core v1.1 與更高版本才提供這項功能。

您可能想要重設群組的部署,以執行下列作業:

  • 刪除群組 (例如,當群組的核心已重映像。)

  • 將該群組的核心移至不同的群組。

  • 將群組回復成任何部署之前的狀態。

  • 移除核心裝置的部署組態。

  • 刪除核心裝置或雲端的敏感資料。

  • 部署新群組組態至核心,且在目前的群組中無須以另一個核心取代此核心。

注意

AWS IoT Greengrass 核心軟體 v1.0.0 中無法使用重設部署功能。您無法刪除已使用 v1.0.0 部署的群組。

重設部署操作會先清除雲端中針對特定群組所儲存的所有部署資訊。它會接著指示群組的核心裝置,同時清除所有與其部署相關的資訊 (Lambda 函數、使用者日誌、陰影資料庫和伺服器憑證,但不包含使用者定義的 config.json 或 Greengrass 核心憑證。)群組目前的部署狀態如果是 In ProgressBuilding,群組部署重設作業就無法啟動。

從 AWS IoT 主控台 重設部署

您可以從 AWS IoT 主控台 中的群組設定頁面中,重設群組部署 。

  1. 在 AWS IoT 主控台中,選擇 Greengrass,然後選擇 Groups (群組)

  2. 選擇目標群組。

  3. Actions (動作) 中,選擇 Reset Deployments (重設部署)

    
                                Greengrass 群組的部署頁面。

使用 AWS IoT Greengrass API 重設部署

您可以在 AWS CLI、AWS IoT Greengrass API 或 AWS 開發套件中使用 ResetDeployments 動作,執行重設部署。本主題中的範例使用 CLI。

aws greengrass reset-deployments --group-id GroupId [--force]

reset-deployments CLI 命令的引數:

--group-id

群組的 ID。使用 list-groups 命令來取得這個值。

--force

選用。如果此群組的裝置發生遺失、遭竊或損毀,請使用此參數。此選項使重設部署程序在雲端中所有的部署資訊均已清除後回報成功,而無需等待核心裝置回應。不過,如果核心裝置為作用中或將為作用中,這時它也會執行清除作業。

reset-deployments CLI 命令的輸出如下所示:

{ "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef", "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef" }

您可以使用 get-deployment-status 命令檢查重設政策的狀態。

aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId

get-deployment-status CLI 命令的引數:

--deployment-id

部署 ID。

--group-id

群組的 ID。

get-deployment-status CLI 命令的輸出如下所示:

{ "DeploymentStatus": "Success", "UpdatedAt": "2017-04-04T00:00:00.000Z" }

當準備重設部署時,DeploymentStatus 會設為 Building。當重設部署準備好但 AWS IoT Greengrass 核心 尚未取得重設部署,則 DeploymentStatusInProgress

如果重設操作失敗,在回應中會傳回錯誤資訊。

另請參閱