Lambda 関数の作成とパッケージ化

Python Lambda 関数を AWS IoT Greengrass コアで実行するには、この関数を Python AWS IoT Greengrass Core SDK の greengrasssdk フォルダとパッケージ化する必要があります。このセクションでは、以下の手順を実行します。

Python AWS IoT Greengrass Core SDK をコンピュータ (AWS IoT Greengrass コアデバイスではありません) にダウンロードします。SDK は、AWS IoT Core コンソールの [ソフトウェア] ページ、または AWS IoT Greengrass Core SDK ダウンロードからダウンロードできます。この手順では、コンソールを使用します。
ダウンロードした SDK ファイルを圧縮解除します。
圧縮解除した SDK から greengrassHelloWorld.py という Python Lambda 関数を取得します。
greengrassHelloWorld.py および greengrasssdk フォルダを含む hello_world_python_lambda.zip という Lambda 関数デプロイパッケージを作成します。
Lambda コンソールを使用して hello_world_python_lambda.zip パッケージをアップロードします。
AWS IoT Core コンソールを使用してパッケージを AWS IoT Greengrass コアデバイスに転送します (グループデプロイ中)。

[AWS IoT Core コンソール] で [ソフトウェア] を選択します。
[SDK] の [AWS IoT Greengrass Core SDK] で、[ダウンロードの設定] を選択します。

注記

SDK は、コンソールの [ソフトウェア] ページ、または AWS IoT Greengrass Core SDK ダウンロードからダウンロードできます。この手順では、コンソールを使用します。
Python 2.7 バージョン 1.3.0を選択し、[Download Greengrass Core SDK] を選択します。
Lambda 関数と SDK を取得できるようにダウンロードした greengrass-core-python-sdk-1.3.0.tar.gz ファイルを解凍します。手順については、オペレーティングシステムに対応するタブを選択してください。
WindowsmacOSUNIX-like system
Windows
Windows で .tar.gz ファイルを解凍するためのツール (7-Zip、WinZip、その他) を使用します。たとえば、以下のステップでは 7-Zip を使用します。
7-Zip をインストールしたら、Windows エクスプローラー (Windows logo key + E) を使用して greengrass-core-python-sdk-1.3.0.tar.gz ファイルに移動し、ファイルを右クリックして [7-Zip]、[Extract Here (ここに展開)] の順に選択します。これにより greengrass-core-python-sdk-1.3.0.tar ファイルが作成されます。

greengrass-core-python-sdk-1.3.0.tar ファイルを右クリックして [7-Zip]、[Extract Here (ここに展開)] の順に選択します。これにより、aws_greengrass_core_sdk フォルダが作成されます。

aws_greengrass_core_sdk フォルダと sdk フォルダを展開し、python_sdk_1_3_0.zip を解凍します。
macOS
Finder で、greengrass-core-python-sdk-1.3.0.tar.gz ファイルに移動してダブルクリックします。これにより、aws_greengrass_core_sdk フォルダが作成されます。

aws_greengrass_core_sdk フォルダと sdk フォルダを展開し、python_sdk_1_3_0.zip を解凍します。
UNIX-like system
ターミナルウィンドウを開き、greengrass-core-python-sdk-1.3.0.tar.gz ファイルが含まれているディレクトリに移動します。

次のコマンドを実行して、ファイルを解凍します。

tar -xzf greengrass-core-python-sdk-1.3.0.tar.gz

これで aws_greengrass_core_sdk ディレクトリが作成されます。

python_sdk_1_3_0.zip ファイルを解凍します。

cd aws_greengrass_core_sdk/sdk sudo unzip python_sdk_1_3_0.zip
このモジュールの Lambda 関数では、以下を使用します。
- examples\HelloWorld の greengrassHelloWorld.py ファイル。これは Lambda 関数コードです。
- sdk\python_sdk_1_3_0 の greengrasssdk フォルダ。これは SDK です。
greengrassHelloWorld.py のコードを次に示します。(スペースを節約するために、すべてのコードコメントは削除されています)。関数は 5 秒ごとに 2 つのメッセージのいずれかを hello/world トピックに発行します。
```
import greengrasssdk
import platform
from threading import Timer
import time

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

def greengrass_hello_world_run():
    if not my_platform:
        client.publish(topic='hello/world', payload='Hello world! Sent from Greengrass Core.')
    else:
        client.publish(topic='hello/world', payload='Hello world! Sent from Greengrass Core running on platform: {}'.format(my_platform))
    Timer(5, greengrass_hello_world_run).start()

greengrass_hello_world_run()

def function_handler(event, context):
    return
```
greengrasssdk を greengrassHelloWorld.py が含まれている HelloWorld フォルダにコピーします。
Lambda 関数デプロイパッケージを作成するには、greengrassHelloWorld.py ファイルと greengrasssdk フォルダを hello_world_python_lambda.zip という名前の圧縮された .zip ファイルに保存します。.py ファイルと SDK フォルダはディレクトリのルートにある必要があります。

UNIX 互換システム (Mac のターミナルを含む) の場合は、次のコマンドを使用してファイルとフォルダをパッケージ化できます。
```
sudo zip -r hello_world_python_lambda.zip greengrasssdk greengrassHelloWorld.py
```
注記

ディストリビューションによっては、必要に応じて最初に zip をインストールします。そのために、sudo apt-get install zip などを実行します(インストールコマンドはお客様のディストリビューションと異なる場合があります)。

これで、Lambda 関数を作成して、デプロイパッケージをアップロードする準備ができました。
Lambda コンソールを開き、[関数の作成] を選択します。
[Author from scratch] を選択します。
関数に Greengrass_HelloWorld という名前を付け、残りのフィールドを以下のように設定します。
- [Runtime] で [Python 2.7] を選択します。
- [ロール] で、[テンプレートから新しいロールを作成] を選択します。
- [ロール名] にロールの一意な名前を入力します。(このロールは AWS IoT Greengrass により使用されません。)
[Create function] を選択します。
Lambda 関数デプロイパッケージをアップロードします。
1. [設定] タブの [関数コード] で、以下のフィールドを設定します。
  - [コードエントリタイプ] で、[.ZIP ファイルをアップロード] を選択します。
  - [Runtime] で [Python 2.7] を選択します。
  - [ハンドラ] に「greengrassHelloWorld.function_handler」と入力します。
2. [アップロード]、[hello_world_python_lambda.zip] の順に選択します(hello_world_python_lambda.zip ファイルのサイズは、以下に示すものと異なる場合があります)。
3. [Save] を選択します。
  
  ヒント
  
  アップロードしたコードを表示するには、[コードエントリタイプ] の [コードをインラインで編集] を選択します。
Lambda 関数を発行します。
1. [アクション] メニューから、[新しいバージョンを発行] を選択します。
2. [バージョンの説明] に「First version」と入力し、[発行] を選択します。
Lambda 関数バージョンのエイリアスを作成します。

注記

Greengrass グループは、Lambda 関数をエイリアス (推奨) またはバージョンで参照できます。エイリアスを使用する方がコード更新の管理が簡単です。関数コードが更新された場合にサブスクリプションテーブルやグループ定義を変更する必要がないためです。代わりに、新しい関数バージョンのエイリアスを指定します。
1. [アクション] から [エイリアスの作成] を選択します。
2. エイリアスに GG_HelloWorld という名前を付け、バージョンを 1 (先ほど発行したバージョンに対応) に設定して、[作成] を選択します。
  
  注記
  
  AWS IoT Greengrass は、$LATEST バージョンの Lambda エイリアスをサポートしていません。