Lambda 関数をコンポーネントとしてインポートする (コンソール)

1. AWS IoT Greengrass コンソールのナビゲーションメニューで、[Components] (コンポーネント) を選択します。

2. [Components] (コンポーネント) ページで、[Create component] (コンポーネントの作成) を選択します。

3. [Component information] (コンポーネント情報) の [Create component] (コンポーネントの作成) ページで、[Import Lambda function] (Lambda 関数のインポート) を選択します。

4. [Lambda function] (Lambda 関数) で、インポートする Lambda 関数を検索して選択します。

   AWS IoT Greengrass は Lambda 関数の名前を使用してコンポーネントを作成します。

5. [Lambda function version] (Lambda 関数のバージョン) で、インポートするバージョンを選択します。$LATEST などの Lambda エイリアスを選択することはできません。

   AWS IoT Greengrass は Lambda 関数のバージョンを有効なセマンティックバージョンに変換してコンポーネントを作成します。例えば、関数のバージョンが 3 である場合、コンポーネントのバージョンは 3.0.0 になります。

1. (オプション) Lambda 関数が作業メッセージのためにサブスクライブするイベントソースのリストを追加します。この関数をローカルのパブリッシュ/サブスクライブメッセージと AWS IoT Core MQTT メッセージにサブスクライブするように、イベントソースに指定できます。Lambda 関数は、イベントソースからメッセージを受信したときに呼び出されます。

   注記

   この関数を他の Lambda 関数またはコンポーネントからのメッセージにサブスクライブするには、この Lambda 関数コンポーネントをデプロイするときにレガシーサブスクリプションルーターコンポーネントをデプロイしてください。レガシーサブスクリプションルーターコンポーネントをデプロイするときは、Lambda 関数が使用するサブスクリプションを指定します。

   [Event sources] (イベントソース) で以下を実行して、イベントソースを追加します。

   1. 追加したイベントソースごとに、次のオプションを指定します。

      • [Topic] (トピック) – メッセージをサブスクライブするためのトピック。

      • [Type] (タイプ) – イベントソースのタイプ。次のオプションから選択します。

        • ローカルの公開/サブスクライブ – ローカルの公開/サブスクライブメッセージに対するサブスクライブ。

          Greengrass nucleus v2.6.0 以降、または Lambda マネージャー v2.2.5 以降を使用する場合、[Topic] (トピック) でタイプを指定する際に、MQTT トピックのワイルドカード (+ および #) を使用できます。

        • AWS IoT Core MQTT – AWS IoT Core MQTT メッセージに対するサブスクライブ。

          [Topic] (トピック) でタイプを指定する際に、MQTT ワイルドカード (+ および #) を使用できます。

   2. 別のイベントソースを追加するには、[Add event source] (イベントソースの追加) をクリックし、前の手順を繰り返します。イベントソースを削除するには、削除するイベントソースの横にある [Remove] (削除) を選択します。

2. [Timeout (seconds)] (タイムアウト (秒)) には、ピン留めされていない Lambda 関数のタイムアウトまでの最大実行時間 (秒) を入力してください。デフォルト値は 3 秒です。

3. [Pinned] (ピン留め) では、Lambda 関数コンポーネントをピン留めするかどうかを選択します。デフォルトは [True] (真) です。

   • ピン留めされた (または存続期間の長い) Lambda 関数は、AWS IoT Greengrass が起動すると起動し、独自のコンテナで実行し続けます。

   • ピン留めされていない (またはオンデマンドの) Lambda 関数は、作業項目を受け取ったときのみ開始し、アイドル状態のまま指定された最大アイドル時間を過ぎると終了します。関数に複数の作業項目がある場合、AWS IoT Greengrass Core ソフトウェアは関数のインスタンスを複数作成します。

4. (オプション) [Additional parameters] (その他のパラメータ) で、以下の Lambda 関数パラメータを設定します。

   • [Status timeout (seconds)] (ステータスタイムアウト (秒)) – Lambda 関数のコンポーネントが Lambda マネージャーコンポーネントにステータスの更新を送信する間隔 (秒)。このパラメータは、ピン留めされた関数にのみ適用されます。デフォルト値は 60 秒です。

   • [Maximum queue size] (最大キューサイズ) – Lambda 関数コンポーネントのメッセージキューの最大サイズ。AWS IoT Greengrass Core ソフトウェアは、Lambda 関数を実行して各メッセージを消費できるまで、FIFO (先入れ先出し) キューにメッセージを保存します。デフォルトはメッセージ 1,000 件です。

   • [Maximum number of instances] (インスタンスの最大数) – ピン留めされていない Lambda 関数が同時に実行できるインスタンスの最大数。デフォルトは 100 件です。

   • [Maximum idle time (seconds)] (最大アイドルタイム (秒)) – AWS IoT Greengrass Core ソフトウェアによりプロセスを停止されるまでに、ピン留めされていない Lambda 関数がアイドル状態でいられる最大時間 (秒)。デフォルト値は 60 秒です。

   • [Encoding type] (エンコードタイプ) – Lambda 関数がサポートするペイロードのタイプ。次のオプションから選択します。

     • JSON

     • バイナリ

     デフォルトは JSON です。

5. (オプション) 実行時に Lambda 関数に渡すコマンドライン引数のリストを指定します。

   1. [Additional parameters, Process arguments] (追加パラメータ、プロセス引数) で [Add argument] (引数を追加) を選択します。

   2. 追加する引数ごとに、関数に渡す引数を入力します。

   3. 引数を削除するには、削除する引数の横にある [Remove] (削除) を選択します。

6. (オプション) 実行時に Lambda 関数を利用できる環境変数を指定してください。環境変数を使用すると、関数コードを変更することなく設定を保存および更新できます。

   1. [Additional parameters, Environment variables] (追加パラメータ、環境変数) で、[Add environment variables] (環境変数を追加) を選択します。

   2. 追加する環境変数ごとに、次のオプションを指定します。

      • [Key] (キー) – 変数名。

      • [Value] (値) – この変数のデフォルト値。

   3. 環境変数を削除するには、削除する環境変数の横にある [Remove] (削除) を選択します。

1. プラットフォームごとに以下のオプションを指定します。

   • [Operating system] (オペレーティングシステム) – プラットフォームのオペレーティングシステムの名前。現在、サポートされている値は linux のみです。

   • [Architecture] (アーキテクチャ) – プラットフォームのプロセッサアーキテクチャ。サポートされている値は以下のとおりです。

     • amd64

     • arm

     • aarch64

     • x86

2. 別のプラットフォームを追加するには、[Add platform] (プラットフォームを追加) を選択して、先の手順を繰り返します。サポートされているプラットフォームを削除するには、削除するプラットフォームの横にある [Remove] (削除) を選択します。

1. [Add dependency] (依存関係の追加) を選択します。

2. 追加したコンポーネントの依存関係ごとに、以下のオプションを指定します。

   • [Component name] (コンポーネント名) – コンポーネント名。たとえば aws.greengrass.StreamManager と入力してストリームマネージャーコンポーネントを含めます。

   • [Version requirement] (バージョン要件) – このコンポーネントの依存関係において互換性のあるバージョンを識別する npm スタイルのセマンティックバージョン制約。1 つのバージョンまたはバージョンの範囲を指定できます。たとえば ^1.0.0 と入力すると、この Lambda 関数がストリームマネージャーコンポーネントの最初のメジャーバージョンのすべてのバージョンに依存することを指定できます。セマンティックバージョン制約の詳細については、npm semver calculator を参照してください。

   • [Type] (タイプ) – 依存関係のタイプ。次のオプションから選択します。

     • [Hard] (強) – 依存関係が状態を変化させると、Lambda 関数コンポーネントが再起動します。デフォルトではこれが選択されています。

     • [Soft] (弱) – 依存関係が状態を変化させても、Lambda 関数コンポーネントは再起動しません。

3. コンポーネントの依存関係を削除するには、コンポーネントの依存関係の横にある[Remove] (削除) を選択します。

コンテナで Lambda 関数を実行する場合は、以下の手順で Lambda 関数のプロセス設定を行います。

1. コンテナを利用できるメモリの量とシステムリソース (ボリュームやデバイスなど) を設定します。

   [Container parameters] (コンテナパラメータ) で以下を行います。

   1. [Memory size] (メモリサイズ) にはコンテナに割り当てるメモリサイズを入力します。メモリサイズは [MB] または [KB] で指定できます。

   2. [Read-only sys folder] (読み取り専用の Sys フォルダ) について、コンテナがデバイスの /sys フォルダから情報を読み取れるかどうか指定します。デフォルトは [False] (偽) です。

2. (オプション) コンテナ化された Lambda 関数がアクセスできるローカルボリュームを設定します。ボリュームを定義すると、AWS IoT Greengrass Core ソフトウェアはソースファイルをコンテナ内の送信先にマウントします。

   1. [Volumes] (ボリューム) で、[Add volume] (ボリュームを追加) を選択します。

   2. 追加したボリュームごとに、次のオプションを指定します。

      • [Physical volume] (物理ボリューム) –コアデバイスのソースフォルダへのパス。

      • [Logical volume] (論理ボリューム) – コンテナの保存先フォルダへのパス。

      • [Permission] (アクセス権限) – (オプション) コンテナからソースフォルダへのアクセス権限。次のオプションから選択します。

        • [Read-only] (読み取り専用) – Lambda 関数はソースフォルダへの読み取り専用アクセス権が与えられます。デフォルトではこれが選択されています。

        • [Read-write] (読み取り/書き取り) – Lambda 関数はソースフォルダへの読み取り/書き込みアクセス権が与えられます。

      • [Add group owner] (グループ所有者の追加) – (オプション) Lambda 関数コンポーネントを実行するシステムグループをソースフォルダの所有者として追加するかどうか。デフォルトは [False] (偽) です。

   3. ボリュームを削除するには、削除するボリュームの横にある [Remove] (削除) を選択します。

3. (オプション) コンテナ化された Lambda 関数がアクセスできるローカルシステムデバイスを設定します。

   1. [Devices] (デバイス) で、[Add device] (デバイスの追加) を選択します。

   2. 追加したデバイスごとに、次のオプションを指定します。

      • [Mount path] (マウントパス) – コアデバイスのシステムデバイスへのパス。

      • [Permission] (アクセス権限) – (オプション) コンテナからシステムデバイスへのアクセス権限。次のオプションから選択します。

        • [Read-only] (読み取り専用) – Lambda 関数はシステムデバイスへの読み取り専用アクセス権が与えられます。デフォルトではこれが選択されています。

        • [Read-write] (読み取り/書き取り) – Lambda 関数はソースフォルダへの読み取り/書き込みアクセス権が与えられます。

      • [Add group owner] (グループ所有者の追加) – (オプション) Lambda 関数コンポーネントを実行するシステムグループをシステムデバイスの所有者として追加するかどうか。デフォルトは [False] (偽) です。