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 ソフトウェアの OTA 更新

AWS IoT Greengrass Core ソフトウェアパッケージには、AWS IoT Greengrass ソフトウェアの Over-the-air (OTA) 更新を実行できる更新エージェントが含まれています。OTA 更新を使用して、最新バージョンの AWS IoT Greengrass Core ソフトウェアまたは OTA 更新エージェントソフトウェアを 1 つ以上の コアにインストールできます。OTA 更新では、コアデバイスが物理的に存在する必要はありません。

可能であれば、OTA 更新を使用することをお勧めします。これらは、更新ステータスと更新履歴を追跡するために使用できるメカニズムを提供します。更新に失敗すると、OTA 更新エージェントは以前のソフトウェアバージョンにロールバックします。

OTA 更新により、以下の作業の効率が向上します。

この機能は、AWS IoT ジョブと統合されています。

要件

AWS IoT Greengrass ソフトウェアの OTA 更新には、以下の要件が適用されます。

OTA 更新の IAM アクセス許可

AWS IoT Greengrass が AWS IoT Greengrass Core ソフトウェアの新しいバージョンをリリースすると、AWS IoT Greengrass は、OTA 更新に使用される Amazon S3 に保存されたソフトウェアアーティファクトを更新します。

AWS アカウント には、これらのアーティファクトにアクセスするために使用できる Amazon S3 URL 署名者ロールが含まれている必要があります。ロールには、ターゲット AWS リージョン 内のバケットに対する s3:GetObject アクションを許可するアクセス許可ポリシーが必要です。ロールには、信頼されたエンティティとしてロールを引き受けることを iot.amazonaws.com に許可する信頼ポリシーも必要です。

さらに、OTA 更新を開始するユーザーには、greengrass:CreateSoftwareUpdateJob および iot:CreateJob を使用するアクセス許可と、iam:PassRole を使用して署名者ロールのアクセス許可を渡すアクセス許可が必要です。IAM ポリシーの例を次に示します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

考慮事項

Greengrass Core ソフトウェアの OTA 更新を開始する前に、Core デバイスと、その Core にローカルに接続されたクライアントデバイスの両方で、Greengrass グループのデバイスへの影響に注意します。

OTA 更新の実行中、以下の状態情報は保持されます。

Greengrass OTA Update Agent

Greengrass OTA 更新エージェントは、クラウドで作成およびデプロイされた更新ジョブを処理する、デバイス上のソフトウェアコンポーネントです。OTA 更新エージェントは、AWS IoT Greengrass Core ソフトウェアと同じソフトウェアパッケージで配布されています。エージェントは /greengrass-root/ota/ota_agent/ggc-ota にあります。ログを /var/log/greengrass/ota/ggc_ota.txt に書き込みます。

OTA 更新エージェントを起動するには、バイナリを手動で実行するか、systemd サービスファイルなどの init スクリプトの一部として統合します。バイナリを手動で実行する場合は、ルートとして実行する必要があります。起動すると、OTA 更新エージェントは AWS IoT Greengrass ソフトウェア更新ジョブを AWS IoT Core からリッスンし、順番に実行します。OTA 更新エージェントは他のすべての AWS IoT ジョブタイプを無視します。

次の抜粋は、OTA 更新エージェントを起動、停止、および再起動する systemd サービスファイルの例を示したものです。

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

更新のターゲットであるコアは、OTA 更新エージェントの 2 つのインスタンスを実行することはできません。実行すると、2 つのエージェントが同じジョブを処理し、それにより競合が発生します。

init システムとの統合

OTA 更新中に、OTA 更新エージェントは Core デバイスのバイナリを再起動します。バイナリが実行中の場合、更新中に init システムが AWS IoT Greengrass Core ソフトウェアまたはエージェントの状態をモニタリングしているとき、競合が発生する可能性があります。OTA 更新メカニズムを init モニタリング戦略と統合するために、更新の前後に実行するシェルスクリプトを記述できます。例えば、データをバックアップしたり、デバイスをシャットダウンする前にプロセスを停止したりする ggc_pre_update.sh スクリプトを記述できます。

これらのシェルスクリプトを実行するように OTA 更新エージェントに指示するには、config.json ファイルに "managedRespawn" : true フラグを含める必要があります。この設定は、次の抜粋に示されています。

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

OTA 更新による管理された再生成

managedRespawn を true に設定した OTA 更新では、以下の要件が適用されます。

OTA 更新エージェントは /greengrass-root/usr/scripts にあるスクリプトを実行します。ディレクトリツリーは次のようになります。

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

managedRespawn が true に設定されている場合、OTA 更新エージェントは、ソフトウェア更新の前後に /greengrass-root/usr/scripts ディレクトリでスクリプトをチェックします。スクリプトがない場合は、更新は失敗します。AWS IoT Greengrass はスクリプトの内容については検証しません。ベストプラクティスとして、スクリプトが正しく機能することを確認した上で、エラーの発生時には適切な終了コードを発行するようにしてください。

OTA 更新の作成

次のステップに従って、1 つ以上のコアで AWS IoT Greengrass ソフトウェアの OTA 更新を実行します。

CreateSoftwareUpdateJob API

CreateSoftwareUpdateJob API を使用して、Core デバイスの AWS IoT Greengrass Core ソフトウェアまたは OTA 更新エージェントソフトウェアを更新できます。この API は、更新が利用可能になったときにデバイスに通知する AWS IoT スナップショットジョブを作成します。CreateSoftwareUpdateJob を呼び出した後は、他の AWS IoT ジョブコマンドを使用して、ソフトウェア更新を追跡できます。詳細については、AWS IoT デベロッパーガイドのジョブを参照してください。

以下の例では、AWS CLI を使用して、コアデバイス上の AWS IoT Greengrass Core ソフトウェアを更新するジョブを作成する方法を示しています。

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

create-software-update-job コマンドは、更新によってインストールされたジョブ ID、ジョブ ARN、およびソフトウェアバージョンを含む JSON レスポンスを返します。

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

create-software-update-job を使用してコアデバイスを更新する方法を示す手順については、「OTA 更新の作成」を参照してください。

create-software-update-job コマンドでは、以下のパラメータを使用します。