重設部署 - AWS IoT Greengrass
從AWS IoT主控台重設部署使用 AWS IoT Greengrass API 重設部署另請參閱

AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長壽命階段。如需詳細資訊，請參閱 AWS IoT Greengrass V1 維護政策 。在此日期之後， AWS IoT Greengrass V1 不會發佈提供功能、增強功能、錯誤修正或安全修補程式的更新。在 上執行的裝置 AWS IoT Greengrass V1 不會中斷，並會繼續運作和連線至雲端。我們強烈建議您遷移至 AWS IoT Greengrass Version 2，這會新增重要的新功能，並支援其他平台 。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

重設部署

此功能適用於AWS IoT Greengrass核心 v1.1 及更高版本。

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

  • 刪除群組，例如當您要將群組的核心移至其他群組時，或已重新建立群組的核心影像。刪除群組之前，您必須重設群組的部署，以便將核心與另一個 Greengrass 群組搭配使用。

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

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

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

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

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

注意

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

重設部署操作會先清除雲端中針對特定群組所儲存的所有部署資訊。然後，它會指示群組的核心裝置也清除所有與部署相關的資訊 (Lambda 函數、使用者記錄檔、陰影資料庫和伺服器憑證，但不是使用者定義config.json或 Greengrass 核心憑證)。群組目前的部署狀態如果是 In Progress 或 Building，群組部署重設作業就無法啟動。

從AWS IoT主控台重設部署

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

  1. 在AWS IoT主控台瀏覽窗格的 [管理] 下，展開 [Greengrass 裝置]，然後選擇 [群組 (V1)]。

  2. 選擇目標群組。

  3. 從「部署」索引標籤中選擇「重設部署」。

  4. 在 [重設此 Greengrass 群組的部署] 對話方塊中，輸入confirm同意，然後選擇 [重設部署]。

使用 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核心尚未選取重設部署時，就DeploymentStatus是InProgress.

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

另請參閱