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 コアでの Lambda 関数の実行

AWS IoT Greengrass は、AWS Lambda で作成するユーザー定義コード用のコンテナ化された Lambda ランタイム環境を提供します。Lambda 関数は、コアのローカル Lambda ランタイムで実行される AWS IoT Greengrass コアにデプロイされます。ローカル Lambda 関数は、ローカルイベント、クラウドからのメッセージやその他のリソースによってトリガーされ、クライアントデバイスにローカルコンピューティングの機能性をもたらします。例えば、データをクラウドに送信する前にデバイスデータをフィルタリングするために、Greengrass Lambda 関数を使用できます。

Lambda 関数をコアにデプロイするには、この関数を Greengrass グループに追加し (既存の Lambda 関数を参照して行います)、この関数に対してグループ固有の設定を行い、グループをデプロイします。この関数が AWS のサービスにアクセスする場合には、必要なアクセス許可を Greengrass グループロールに追加する必要もあります。

Lambda 関数の実行方法 (アクセス許可、分離、メモリ制限など) を指定するパラメータを設定できます。詳細については、「グループ固有の設定による Greengrass Lambda 関数の実行の制御」を参照してください。

以下の表は、サポートされる AWS Lambda ランタイムおよび実行できる AWS IoT Greengrass Core ソフトウェアのバージョンを一覧表示しています。

* サポートされているバージョンの AWS IoT Greengrass では、これらのランタイムを使用する Lambda 関数を実行できますが、AWS Lambda で作成することはできません。デバイスのランタイムがその関数のために指定された AWS Lambda ランタイムと異なる場合、FunctionDefintionVersion の FunctionRuntimeOverride を使用して独自のランタイムを選択できます。詳細については、「」を参照してくださいCreateFunctionDefinition。サポートされているランタイムの詳細については、「AWS Lambda デベロッパーガイド」 の「Runtime support policy」(ランタイムのサポートポリシー) を参照してください。

Greengrass Lambda 関数の SDK

AWS には、AWS IoT Greengrass コアで実行する Greengrass Lambda 関数で使用できる 3 つの SDK があります。これらの SDK は別々のパッケージに含まれているため、関数で同時に使用できます。Greengrass Lambda 関数で SDK を使用するには、AWS Lambda にアップロードする Lambda 関数デプロイパッケージに SDK を含めます。

デプロイパッケージの作成の詳細については、入門チュートリアルの「Lambda 関数の作成とパッケージ化」あるいは「AWS Lambda デベロッパーガイド」の「デプロイパッケージの作成」を参照してください。

クラウドベースの Lambda 関数への移行

AWS IoT Greengrass Core SDK は、AWS SDK プログラミングモデルに従って、クラウド向けに開発された Lambda 関数を AWS IoT Greengrass コア上で実行する Lambda 関数に簡単に移植します。

例えば、次の Python Lambda 関数は、AWS SDK for Python (Boto3) を使用して、クラウドでトピック some/topic にメッセージを発行します。

import boto3

iot_client = boto3.client("iot-data")
response = iot_client.publish(
    topic="some/topic", qos=0, payload="Some payload".encode()
)

AWS IoT Greengrass 向けの関数を移植するには、次の例に示すように、import ステートメントおよび client 初期化で boto3 モジュール名を greengrasssdk に変更します。

import greengrasssdk

iot_client = greengrasssdk.client("iot-data")
iot_client.publish(topic="some/topic", qos=0, payload="Some payload".encode())

また、プログラミングモデル間の類似性により、クラウド上で開発した Lambda 関数を最小限の労力で AWS IoT Greengrass に移行することが可能になります。Lambda 実行可能ファイルはクラウド上で実行されないため、デプロイ前に AWS SDK を使用してこれらをクラウド上で開発することはできません。

エイリアスまたはバージョンによる Lambda 関数のリファレンス

Greengrass グループは、Lambda 関数をエイリアス別 (推奨) またはバージョン別に参照できます。エイリアスを使用すると、関数コードを更新する時にサブスクリプションテーブルやグループ定義を変更する必要がないため、コード更新を簡単に管理できます。その代わりに、新しい関数バージョンにエイリアスを指定するだけで済みます。エイリアスは、グループデプロイ中にバージョン番号を解決します。エイリアスを使用すると、解決されたバージョンはデプロイ時にエイリアスが示すバージョンに更新されます。

AWS IoT Greengrass は、$LATEST バージョンの Lambda エイリアスをサポートしていません。$LATEST バージョンは、イミュータブルで発行された関数バージョンにバインドされず、いつでも変更できます。これは、AWS IoT Greengrass のバージョン普遍性の原則とは異なります。

Greengrass Lambda 関数がコード変更によって常に更新されるようにするための一般的な方法は、Greengrass グループとサブスクリプションで PRODUCTION という名前のエイリアスを使用することです。Lambda 関数の新しいバージョンを本稼働環境に移行すると、エイリアスが最新の安定バージョンを示し、グループを再デプロイします。また、このメソッドを使用して以前のバージョンにロールバックすることもできます。

Greengrass Lambda 関数のコミュニケーションフロー

Greengrass Lambda 関数は、AWS IoT Greengrass グループの他のメンバー、ローカルサービス、およびクラウドサービス (AWS サービスを含む) と通信するためのいくつかの方法をサポートします。

MQTT メッセージを使用した通信

Lambda 関数は、サブスクリプションによって制御される発行 - サブスクリプションパターンを使用して MQTT メッセージを送受信できます。

このコミュニケーションフローにより、Lambda 関数は以下のエンティティとメッセージを交換することができる。

サブスクリプションは、メッセージ送信元、メッセージターゲット、および送信元からターゲットへのメッセージのルーティングに使用されるトピック (または件名) を定義します。Lambda 関数に発行されるメッセージは、関数に登録されたハンドラに渡されます。サブスクリプションはより高度なセキュリティを可能にし、予測可能なやり取りを提供します。詳細については、「MQTT メッセージングワークフローにおけるマネージドサブスクリプション」を参照してください。

他の通信フロー

入力 MQTT トピック (または件名) の取得

AWS IoT Greengrass は、サブスクリプションを使用して、グループ内のクライアントデバイス、Lambda 関数、およびコネクタ間の MQTT メッセージの交換を制御し、さらに AWS IoT またはローカルシャドウサービスを使用します。サブスクリプションは、メッセージソース、メッセージターゲット、およびメッセージのルーティングに使用される MQTT トピックを定義します。ターゲットが Lambda 関数の場合、ソースがメッセージを発行すると、関数のハンドラが呼び出されます。詳細については、「MQTT メッセージを使用した通信」を参照してください。

次の例は、Lambda 関数がハンドラに渡された context から入力トピックを取得する方法を示しています。これを行うには、コンテキスト階層から subject キーにアクセスします (context.client_context.custom['subject'])。この例では、入力 JSON メッセージも解析してから、解析したトピックとメッセージを発行します。

import greengrasssdk
import logging

client = greengrasssdk.client('iot-data')

OUTPUT_TOPIC = 'test/topic_results'

def get_input_topic(context):
    try:
        topic = context.client_context.custom['subject']
    except Exception as e:
        logging.error('Topic could not be parsed. ' + repr(e))
    return topic
    
def get_input_message(event):
    try:
        message = event['test-key']
    except Exception as e:
        logging.error('Message could not be parsed. ' + repr(e))
    return message

def function_handler(event, context):
    try:
        input_topic = get_input_topic(context)
        input_message = get_input_message(event)
        response = 'Invoked on topic "%s" with message "%s"' % (input_topic, input_message)
        logging.info(response)
    except Exception as e:
        logging.error(e)

    client.publish(topic=OUTPUT_TOPIC, payload=response)

    return

関数をテストするには、デフォルトの設定を使用してグループに追加します。次に、以下のサブスクリプションを追加し、グループをデプロイします。手順については、「モジュール 3 (パート 1): AWS IoT Greengrass での Lambda 関数」を参照してください。

デプロイが完了したら、関数を呼び出します。

Greengrass Lambda 関数のライフサイクル設定

Greengrass Lambda 関数ライフサイクルは、関数が開始する時期とどのようにコンテナを作成して使用するかを定義します。また、ライフサイクルは関数ハンドラの外部にある変数および処理中のロジックが保持されるかを定義します。

AWS IoT Greengrass は、オンデマンド (デフォルト) または 長い存続期間のライフサイクルをサポートしています。

コンテナの再利用に関する詳細は、AWS コンピューティングブログで「AWS Lambda のコンテナの再利用について」を参照してください。

Lambda 実行可能ファイル

この機能は AWS IoT Greengrass Core v1.6 以降で使用できます。

Lambda 実行可能ファイルは、コア環境でバイナリコードを実行するために使用できる Greengrass Lambda 関数の一種です。これによって、デバイス固有の機能を実行することができ、コンパイルされたコードの小さなフットプリントの利点を活用できます。Lambda 実行可能ファイルは、イベントによる呼び出し、他の関数の呼び出し、そしてローカルリソースにアクセスが可能です。

Lambda 実行可能ファイルはバイナリエンコードタイプのみ (JSON ではなく) をサポートします。それ以外では、Greengrass グループで管理し、他の Greengrass Lambda 関数のようにデプロイできます。ただし、Lambda 実行可能ファイルを作成するプロセスは、Python、Java、および Node.js の Lambda 関数とは異なります。

Lambda 実行可能ファイルでは、その関数コードに特定の呼び出しおよびプログラミングパターンが実装されている必要があります。例えば、main メソッドは次を満たす必要があります。

次のスニペットは、 の simple_handler.c コード例の mainメソッドです GitHub。

int main() {
    gg_error err = GGE_SUCCESS;

    err = gg_global_init(0);
    if(err) {
        gg_log(GG_LOG_ERROR, "gg_global_init failed %d", err);
        goto cleanup;
    }

    gg_runtime_start(handler, 0);

cleanup:
    return -1;
}

実装の要件や制限などの詳細については、「AWS IoT Greengrass Core SDK for C」を参照してください。

Lambda 実行可能ファイルを作成する

SDK でコードをコンパイルしたら、AWS Lambda API を使用して Lambda 関数を作成し、コンパイルした実行可能ファイルをアップロードします。

次の例では、create-function CLI コマンドを使用して、Lambda 実行可能ファイルを作成します。このコマンドは以下を指定します。

aws lambda create-function \
--region aws-region \
--function-name function-name \
--handler executable-name \
--role role-arn \
--zip-file fileb://file-name.zip \
--runtime arn:aws:greengrass:::runtime/function/executable

次に、AWS Lambda API を使用してバージョンを発行し、エイリアスを作成します。

次に、Lambda 実行可能ファイルを Greengrass グループに追加し、このグループ固有の設定でバイナリ入力データを受け入れるように設定して、グループをデプロイします。これは AWS IoT Greengrass コンソールまたは AWS IoT Greengrass API を使用して実行できます。