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 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 になります。
リセットオペレーションが失敗すると、エラー情報がレスポンスで返されます。
以下も参照してください。
-
ResetDeployments AWS IoT Greengrass Version 1 API リファレンスの
-
GetDeploymentStatus AWS IoT Greengrass Version 1 API リファレンスの
