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 グループを AWS IoT Greengrass Core にデプロイする

AWS IoT Greengrass グループは、エッジ環境でエンティティを整理するために使用されます。また、グループ内のエンティティ同士のやり取りや、AWS クラウド とのやり取りを制御する用途にも使用します。例えば、グループ内の Lambda 関数のみをローカルでの実行用にデプロイし、グループ内のデバイスのみがローカル MQTT サーバーを使用して通信できます。

グループには Core, が含まれている必要があります。これは AWS IoT Greengrass Core ソフトウェアを実行する AWS IoT デバイスです。コアはエッジゲートウェイとして機能し、エッジ環境で AWS IoT Core 機能を提供します。ビジネスニーズに応じて、次のエンティティをグループに追加することもできます。

AWS クラウド で Greengrass グループを管理し、コアにデプロイします。デプロイは、グループ設定を Core デバイスの group.json ファイルにコピーします。このファイルは greengrass-root/ggc/deployments/group にあります。

AWS IoT コンソールからのグループのデプロイ

グループをデプロイし、そのデプロイを管理するには、AWS IoT コンソールでグループの設定ページを使用します。

AWS IoT Greengrass API を使用したグループのデプロイ

AWS IoT Greengrass API では、AWS IoT Greengrass グループをデプロイし、グループのデプロイを管理するために、次のアクションが用意されています。これらのアクションは AWS CLI、AWS IoT Greengrass API、または AWS SDK から呼び出すことができます。

グループ ID の取得

グループ ID は、API アクションで共通して使用されます。 ListGroups アクションを使用して、グループのリストからターゲットグループの ID を検索できます。例えば、AWS CLIで、list-groups コマンドを使用します。

aws greengrass list-groups

結果をフィルタリングする query オプションを含めることもできます。例:

以下に、list-groups 応答の例を示します。各グループの情報には、グループの ID (Id プロパティ) と最新のグループバージョンの ID (LatestVersion プロパティ) が含まれます。グループの他のバージョン ID を取得するには、ListGroupVersions とともにグループ ID を使用します。

{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

AWS リージョン を指定しない場合、AWS CLI コマンドはプロファイルからデフォルトのリージョンを使用します。別のリージョンのグループを返すには、リージョンオプションを含めます。例:

aws greengrass list-groups --region us-east-1

AWS IoT Greengrass グループオブジェクトモデルの概要

AWS IoT Greengrass API を使用してプログラミングするときは、Greengrass グループオブジェクトモデルを理解しておくと便利です。

グループ

AWS IoT Greengrass API では、最上位の Group オブジェクトはメタデータと GroupVersion オブジェクトのリストで構成されます。GroupVersionオブジェクトは ID によってに Group 関連付けられます。

グループバージョン

GroupVersion オブジェクトは、グループメンバーシップを定義します。各 GroupVersion は、ARN によって CoreDefinitionVersion およびその他のコンポーネントバージョンを参照します。これらの参照は、グループに含めるエンティティを決定します。

例えば、グループに 3 つの Lambda 関数、1 つのデバイス、2 つのサブスクリプションを含めるには、GroupVersion で次を参照します。

コアデバイスにデプロイされた GroupVersion によって、ローカル環境で使用できるエンティティと、それらのエンティティがどのようにやり取りできるかが決まります。

グループコンポーネント

グループに追加するコンポーネントには、3 つのレベルの階層があります。

次の例では、DeviceDefinition は、それぞれに複数の Device オブジェクトを含む 3 つの DeviceDefinitionVersion オブジェクトを参照します。グループでは、一度に 1 つの DeviceDefinitionVersion のみが使用されます。

グループの更新

AWS IoT Greengrass API では、バージョンを使用してグループの設定を更新します。バージョンは変更不可であるため、グループコンポーネントを追加、削除、または変更するには、新規または更新されたエンティティを含む DefinitionVersion オブジェクトを作成する必要があります。

新しい DefinitionVersions オブジェクトを新規または既存の定義オブジェクトに関連付けることができます。例えば、 CreateFunctionDefinition アクションを使用して、FunctionDefinitionVersion を初期バージョンとして含む FunctionDefinition を作成したり、 CreateFunctionDefinitionVersion アクションを使用して既存の FunctionDefinition を参照したりできます。

グループコンポーネントを作成したら、そのグループのメンバーにする、すべての DefinitionVersion オブジェクトを含む GroupVersion を作成します。次に、GroupVersion をデプロイします。

GroupVersion をデプロイするには、1 つだけ Core を含む CoreDefinitionVersion を参照する必要があります。参照されるエンティティはすべて、グループのメンバーである必要があります。また、Greengrass サービスロールは、GroupVersion をデプロイする AWS リージョン の AWS アカウント に関連付けられている必要があります。

AWS リソースを参照するエンティティの更新

Greengrass Lambda 関数とシークレットリソースは、Greengrass 固有のプロパティを定義し、対応する AWS リソースも参照します。これらのエンティティを更新するには、Greengrass オブジェクトではなく、対応する AWS リソースに変更を加えます。例えば、Lambda 関数は AWS Lambda 内の関数を参照し、Greengrass グループに固有のライフサイクルやその他のプロパティも定義します。

以下も参照してください。