AWS Management Console を使用したローカルリソースアクセスを設定する方法

コンピュータで、以下の Python スクリプトを lraTest.py という名前のローカルファイルにコピーします。これは、Lambda 関数のアプリケーションロジックです。

# Demonstrates a simple use case of local resource access.
# This Lambda function writes a file test to a volume mounted inside
# the Lambda environment under destLRAtest. Then it reads the file and 
# publishes the content to the AWS IoT LRAtest topic. 

import sys
import greengrasssdk
import platform
import os
import logging

# Setup logging to stdout
logger = logging.getLogger(__name__)
logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)

# Create a Greengrass Core SDK client.
client = greengrasssdk.client('iot-data')
volumePath = '/dest/LRAtest'

def function_handler(event, context):
    try:
        client.publish(topic='LRA/test', payload='Sent from AWS IoT Greengrass Core.')
        volumeInfo = os.stat(volumePath)
        client.publish(topic='LRA/test', payload=str(volumeInfo))
        with open(volumePath + '/test', 'a') as output:
            output.write('Successfully write to a file.')
        with open(volumePath + '/test', 'r') as myfile:
            data = myfile.read()
        client.publish(topic='LRA/test', payload=data)
    except Exception as e:
        logger.error('Failed to publish message: ' + repr(e))
    return

AWS IoT Greengrass Core SDK のダウンロードページから、AWS IoT Greengrass Core SDK for Python をお使いのコンピュータにダウンロードします。

ダウンロードしたパッケージを解凍し、SDK を取得します。SDK は greengrasssdk フォルダです。

以下の項目を lraTestLambda.zip という名前のファイルに圧縮します。

lraTestLambda.zip ファイルは Lambda 関数デプロイパッケージです。これで、Lambda 関数を作成して、デプロイパッケージをアップロードする準備ができました。

AWS Management Console で、[サービス] を選択し、AWS Lambda コンソールを開きます。

関数を選択します。

[Create function] (関数の作成) を選択し、[Author from scratch] (一から作成) を選択します。

[Basic information] セクションで、以下の値を指定します。

1. [Function name] (関数名) に TestLRA と入力します。

2. [Runtime (ランタイム)] で [Python 3.7] を選択します。

3. [Permissions] (アクセス許可) はデフォルト設定のままにしておきます。これで Lambda への基本的なアクセス許可を付与する実行ロールが作成されます。このロールは、AWS IoT Greengrass によっては使用されません。

[Create function] (関数の作成) を選択します。

Lambda 関数デプロイパッケージをアップロードし、ハンドラを登録します。

1. [Code] (コード) タブの [Code source] (コードソース) で、[Upload from] (アップロード元) を選択します。ドロップダウンから [.zip file] (.zip ファイル) を選択します。

   

2. [Upload] (アップロード) を選択し、lraTestLambda.zip デプロイパッケージを選択します。次に、保存を選択します。

3. 関数の [Code] (コード) タブにある [Runtime settings] (ランタイム設定) で [Edit] (編集) を選択し、次の値を入力します。

   • [Runtime (ランタイム)] で [Python 3.7] を選択します。

   • [ハンドラ] で、[lraTest.function_handler] と入力します。

4. [Save] を選択します。

   注記

   AWS Lambda コンソールの [Test] (テスト) ボタンは、この関数では機能しません。AWS IoT Greengrass Core SDK には、AWS Lambda コンソールで Greengrass Lambda 関数を個別に実行するために必要なモジュールは含まれていません。これらのモジュール (例えば greengrass_common) が関数に提供されるのは、Greengrass Core にデプロイされた後になります。

次に、Lambda 関数の最初のバージョンを発行します。次に、バージョンのエイリアスを作成します。

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

[アクション] メニューから、[新しいバージョンを発行] を選択します。

[バージョンの説明] に「First version」と入力し、[発行] を選択します。

[TestLRA:1] 設定ページで、[Actions] から、[Create alias] を選択します。

[エイリアスの作成] ページの [名前] に、「test」と入力します。[バージョン] に、[1] と選択します。

[Create] を選択します。

Greengrass グループに Lambda 関数を追加できるようになりました。

AWS IoT コンソールのナビゲーションペインの [Manage] (管理) で、[Greengrass devices] (Greengrass デバイス) を展開して、[Groups (V1)](グループ (V1)) を選択します。

Lambda 関数を追加する Greengrass グループを選択します。

グループ設定ページで、[Lambda functions] (Lambda 関数) タブを選択します。

[My Lambda functions] （自分の Lambda 関数) セクションで、 [Add] (追加) を選択します。

[Add Lambda function] (Lambda 関数の追加) ページで、 [Lambda function](Lambda 関数)を選択します。TestLRA を選択します。

[Lambda 関数のバージョン] を選択します。

[Lambda function configuration] (Lambda 関数の設定) セクションで、[System user and group] (システムユーザーとグループ)、[Lambda function containerization] (Lambda 関数のコンテナ化) の順に選択します。

次に、Lambda 関数のライフサイクルを設定します。

[タイムアウト] で、[30 秒] を選択します。

ページの下部で、[Add Lambda function] (Lambda 関数の追加) を選択します。

グループ設定ページで、[Resources] (リソース) タブを選択します。

[Local resources] (ローカルリソース) セクションから [Add] (追加)を選択します。

[Add a local resource] (ローカルリソースの追加) ページで、次の値を使用します。

1. [リソース名] に testDirectory と入力します。

2. [リソースタイプ] で、[ボリューム] を選択します。

3. [Local device path] (ローカルデバイスパス) には、「/src/LRAtest」と入力します。このパスはホスト OS 上に存在している必要があります。

   ローカルデバイスは、コアデバイスのファイルシステム上のリソースのローカル絶対パスです。この場所は、関数が実行されるコンテナの外側です。このパスの先頭を /sys にすることはできません。

4. [送信先] に「/dest/LRAtest」と入力します。このパスはホスト OS 上に存在している必要があります。

   送信先パスは、Lambda 名前空間にあるリソースの絶対パスです。この場所は、関数が実行されるコンテナの内側です。

5. [System group owner and file access permission] (システムグループ所有者のファイルアクセス許可) で、[Automatically add file system permissions of the system group that owns the resource] (リソースを所有する システムグループのファイルシステム権限を自動的に追加する) を選択します。

   [System group owner and file access permission] (システムグループ所有者のファイルアクセス権限) オプションを使用すると、Lambda プロセスに追加のファイルアクセス権限をグラントできます。詳細については、「グループ所有者のファイルアクセス権限」を参照してください。

[Add resource] (リソースを追加) を選択します。[リソース] ページで、新しい testDirectory リソースが表示されます。

グループ設定ページで、[Subscriptions] (サブスクリプション) タブを選択します。

[Add] (追加) を選択します。

[Create a subscription] (サブスクリプションの作成) ページで、ソースおよびターゲットを次のように設定します。

1. [Source type] (ソースタイプ) で、[Lambda function] (Lambda 関数)、[TestLRA] の順に選択します。

2. [Target type] (ターゲットタイプ)で、[Service] (サービス)、[IoT Cloud] (IoT クラウド) の順に選択します。

3. [Topic filter] (トピックのフィルター) で、LRA/test と入力し、 [Create subscription] (サブスクリプションの作成) を選択します。

[Subscriptions] ページに新しいサブスクリプションが表示されます。

次に、AWS IoT から関数を呼び出すサブスクリプションを設定します。

[Subscriptions] ページで [Add Subscription] を選択します。

[ソースとターゲットの選択] ページで、ソースおよびターゲットを次のように設定します。

1. [Source type] (ソースタイプ) で、[Lambda function] (Lambda 関数)、[IoT Cloud] (IoT クラウド) の順に選択します。

2. [Target type] (ターゲットタイプ) で、[Service] (サービス)、[TestLRA]の順に選択します。

3. [Next] を選択します。

[トピックでデータをフィルタリングする] ページの [トピックフィルター] に「invoke/LRAFunction」と入力し、[Next (次へ)] を選択します。

[Finish] (終了) を選択します。[Subscriptions] ページに両方のサブスクリプションが表示されます。

AWS IoT Greengrass Core が実行されていることを確認します。必要に応じて、Raspberry Pi のターミナルで以下のコマンドを実行します。

1. デーモンが実行中であるかどうかを確認するには

   ps aux | grep -E 'greengrass.*daemon'

   出力に root の /greengrass/ggc/packages/1.11.6/bin/daemon エントリが含まれる場合、デーモンは実行されています。

   注記

   パスのバージョンは、コアデバイスにインストールされている AWS IoT Greengrass Core ソフトウェアのバージョンによって異なります。

2. 次のようにしてデーモンを開始します。

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

グループ設定ページで、[Deploy] (デプロイ) を選択します。

プロンプトが表示されたら、[Lambda function] (Lambda 関数) タブの [System Lambda functions] (システム Lambda 関数) から、[IP detector] (IP ディテクター)、[Edit] (編集)、[Automatically detect] (自動的に検出) の順に選択します。

これにより、デバイスは、IP アドレス、DNS、ポート番号など、コアの接続情報を自動的に取得できます。自動検出が推奨されますが、AWS IoT Greengrass は手動で指定されたエンドポイントもサポートしています。グループが初めてデプロイされたときにのみ、検出方法の確認が求められます。

[Deployments] ページでは、デプロイのタイムスタンプ、バージョン ID、ステータスが表示されます。完了すると、デプロイステータスは、[Completed] (完了) になります。

トラブルシューティングヘルプについては、AWS IoT Greengrass のトラブルシューティング を参照してください。

[AWS IoT console] (- コンソール) ナビゲーションメニューから、[Test] (テスト) で、 [MQTT test client] (MQTT テストクライアント) を選択します。

[Subscribe to a topic] (トピックへのサブスクライブ) で、[Topic filter] (トピックのフィルター) に、LRA/testと入力します。

[Additional information] (追加情報) から、[MQTT payload display] (MQTT ペイロード表示) で、[Display payloads as strings] (文字列としてペイロードを表示) を選択します。

[Subscribe] (サブスクライブ) を選択します。Lambda 関数は LRA/test トピックに発行します。

[Publish to a topic] (トピックに発行) から、[Topic name] (トピック名) で、invoke/LRAFunctionと入力し、[Publish] (発行) を選択して、Lambda 関数を呼び出します。ページに関数の 3 つのメッセージペイロードが表示されている場合、テストは成功です。