2023 年 6 月 30 日に AWS IoT Greengrass Version 1 は延長ライフサイクルフェーズに入りました。詳細については、「AWS IoT Greengrass V1 メンテナンスポリシー」を参照してください。この日付以降、AWS IoT Greengrass V1 の機能、拡張機能、バグ修正、またはセキュリティパッチを提供するアップデートはリリースされません。AWS IoT Greengrass V1 で稼働中のデバイスは中断されず、引き続き動作し、クラウドに接続できます。重要な新機能や新たなプラットフォームのサポートが追加された AWS IoT Greengrass Version 2 への移行を強くお勧めします。
デプロイのリセット
この機能は AWS IoT Greengrass Core v1.1 以降で使用できます。
グループのデプロイを次のようにリセットできます。
-
グループのコアを別のグループに移動する場合や、グループのコアのイメージが再作成されている場合などに、グループを削除します。別の Greengrass グループでコアを使用するには、グループを削除する前に、グループのデプロイをリセットする必要があります。
-
グループのコアを別のグループに移動する。
-
すべてのデプロイ前の状態にグループを戻す。
-
コアデバイスからデプロイの設定を削除する。
-
コアデバイスあるいはクラウドから機密データを削除する。
-
現在のグループのコアを別のものに置き換えることなく、新規グループの設定をコアにデプロイする。
注記
デプロイのリセット機能は、AWS IoT Greengrass Core ソフトウェア v1.0.0 では使用できません。v1.0.0 を使用してデプロイされたグループを削除することはできません。
デプロイのリセットオペレーションは、まず、特定のグループのクラウドに保存されているすべてのデプロイ情報をクリーンアップします。そして、グループのコアデバイスにデプロイ関連のすべての情報を消去するよう指示します (ユーザー定義の config.json や Greengrass コア証明書を除く、Lambda 関数、ユーザーログ、シャドウデータベース、サーバー証明書)。グループに現在 In Progress あるいは Building 状態のデプロイがある場合には、このグループのデプロイのリセットを開始できません。
AWS IoT コンソールからのデプロイのリセット
グループのデプロイは、AWS IoT コンソールのグループ設定ページからリセットできます。
AWS IoT コンソールのナビゲーションペインの [Manage] (管理) で、[Greengrass devices] (Greengrass デバイス) を展開して、[Groups (V1)] (グループ (V1))を選択します。
-
ターゲットグループを選択します。
-
[Deployments] (デプロイ) タブから、[Reset deployments] (デプロイのリセット) を選択します。
-
[Reset deployments for this Greengrass Group] (この Greengrass グループのデプロイをリセットする) ダイアログボックスで、
confirmと入力して同意し、[Reset deployment] (デプロイのリセット) を選択します。
AWS IoT Greengrass API を使用したデプロイのリセット
AWS CLI、AWS IoT Greengrass API、または AWS SDK で ResetDeployments アクションを使用して、デプロイをリセットできます。このトピックの例では、CLI を使用しています。
aws greengrass reset-deployments --group-idGroupId[--force]
CLI コマンド reset-deployments の引数
--group-id-
グループ ID。この値を取得するには、
list-groupsコマンドを使用します。 --force-
オプション。グループのコアデバイスが紛失、盗難または破壊された場合には、このパラメータを使用します。このオプションでは、コアデバイスのレスポンスを待たずに、すべてのデプロイ情報がクラウドから消去された後でデプロイリセットプロセスから成功の報告を行います。ただし、コアデバイスがアクティブであるか、アクティブになった場合は、クリーンアップオペレーションも実行します。
CLI コマンド reset-deployments の出力は次のようになります。
{ "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" }
デプロイのリセット状態は、CLI コマンド get-deployment-status で確認できます。
aws greengrass get-deployment-status --deployment-idDeploymentId--group-idGroupId
CLI コマンド get-deployment-status の引数
--deployment-id-
デプロイ ID。
--group-id-
グループ ID。
CLI コマンド get-deployment-status の出力は次のようになります。
{ "DeploymentStatus": "Success", "UpdatedAt": "2017-04-04T00:00:00.000Z" }
デプロイのリセット準備中は、DeploymentStatus が Building に設定されます。デプロイのリセット準備が完了し、AWS IoT Greengrass コアがデプロイのリセットを取得するまでは、DeploymentStatus が InProgress になります。
リセットオペレーションが失敗すると、エラー情報がレスポンスで返されます。
以下も参照してください。
-
「AWS IoT Greengrass Version 1 API リファレンス」の「ResetDeployments」
-
「AWS IoT Greengrass Version 1 API リファレンス」の「GetDeploymentStatus」
