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 グループを 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 プロパティ) が含まれます。グループの他のバージョン IDs を取得するには、 でグループ ID を使用しますListGroupVersions。

{
    "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 グループに固有のライフサイクルやその他のプロパティも定義します。

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