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これにより、重要な新機能が追加され、プラットフォーム のサポートが追加されます。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Lambda 関数とコネクタを使用してローカルリソースにアクセスする
この機能は AWS IoT Greengrass Core v1.3 以降で使用できます。
AWS IoT Greengrass では、AWS Lambda 関数を作成して、クラウドにコネクタを設定し、ローカル実行できるようにコアデバイスにデプロイします。Linux を実行する Greengrass Core で、これらのローカルにデプロイされた Lambda 関数およびコネクタは、Greengrass Core デバイスに物理的に存在するローカルリソースにアクセスできます。例えば、Modbus または CANbus を介して接続されているデバイスと通信するには、Lambda 関数を有効にして、Core デバイスのシリアルポートにアクセスします。ローカルリソースへの安全なアクセスを設定するには、物理的なハードウェアおよび Greengrass コアデバイス OS のセキュリティを保証する必要があります。
ローカルリソースへのアクセスを開始するには、次のチュートリアルを参照してください。
サポートされているリソースタイプ
ボリュームリソースとデバイスリソースの 2 種類のローカルリソースにアクセスできます。
- ボリュームリソース
-
ルートファイルシステム上のファイルまたはディレクトリ (
/sys、/devまたは/varを除く)。具体的には次のとおりです。-
Greengrass Lambda 関数 (例えば、
/usr/lib/python2.x/site-packages/local) を介して情報を読み書きするためのフォルダまたはファイル。 -
ホストの /proc ファイルシステムのフォルダまたはファイル (
/proc/netまたは/proc/statなど)。v1.6 以降でサポートされています。追加の要件については、「/proc ディレクトリのボリュームリソース」を参照してください。
ヒント
/var、/var/run、および/var/libディレクトリをボリュームリソースとして設定するには、最初にディレクトリを別のフォルダにマウントし、フォルダをボリュームリソースとして設定します。ボリュームリソースを設定するときは、ソースパスと送信先パスを指定します。ソースパスはホスト上のリソースの絶対パスです。送信先パスは Lambda 名前空間環境内のリソースの絶対パスです。これは、Greengrass Lambda 関数またはコネクタが実行されるコンテナです。送信先パスの変更はホストファイルシステムのソースパスに反映されます。
注記
送信先パスのファイルは Lambda 名前空間でのみ表示されます。通常の Linux 名前空間では表示できません。
-
- デバイスリソース
-
/devの下にあるファイル。/devの下のキャラクターデバイスまたはブロックデバイスだけがデバイスリソースに使用できます。具体的には次のとおりです。-
シリアルポート (
/dev/ttyS0や/dev/ttyS1など) を介して接続されたデバイスとの通信に使用されるシリアルポート。 -
USB 周辺機器 (
/dev/ttyUSB0または/dev/bus/usbなど) を接続するために使用される USB。 -
GPIO (
/dev/gpiomemなど) を介してセンサーとアクチュエーターに使用される GPIO。 -
オンボード GPU (
/dev/nvidia0など) を使用して機械学習を加速するために使用される GPU。 -
画像や動画のキャプチャに使用されるカメラ (
/dev/video0など)。
注記
/dev/shmは例外です。これは、ボリュームリソースとしてのみ設定できます。/dev/shmリソースにはrwアクセス許可が付与されている必要があります。 -
AWS IoT Greengrass は、Machine Learning (ML) Inference の実行に使用されるリソースタイプもサポートしています。詳細については、「機械学習の推論を実行する」を参照してください。
要件
ローカルリソースへのセキュアなアクセスの設定には、以下の要件が適用されます。
-
AWS IoT Greengrass Core ソフトウェア v1.3 以降を使用している必要があります。ホストの /proc ディレクトリにリソースを作成するには、v1.6 以降を使用する必要があります。
-
ローカルリソース (必要なドライバーとライブラリのすべてを含む) は、Greengrass コアデバイスに正しくインストールされ、使用中も常にアクセス可能であることが必要です。
-
必要になるリソースの操作とリソースへのアクセスに root 権限は不要です。
-
readまたはread and writeアクセス許可のみが使用可能です。Lambda 関数は、リソースに対して特別な権限が必要なオペレーションを実行することはできません。 -
Greengrass コアデバイスのオペレーティングシステム上のローカルリソースの完全パスを指定することが必要です。
-
リソース名または ID の最大長は 128 文字で、パターン
[a-zA-Z0-9:_-]+を使用する必要があります。
/proc ディレクトリのボリュームリソース
ホストの /proc ディレクトリにあるボリュームリソースには、以下の考慮事項が適用されます。
AWS IoT Greengrass Core ソフトウェア v1.6 以降を使用している必要があります。
Lambda 関数には読み取り専用アクセスを許可できますが、読み取り/書き込みアクセスは許可できません。このレベルのアクセスは、AWS IoT Greengrass によって管理されます。
また、ファイルシステムに読み取りアクセスを可能にする OS グループ権限を付与することが必要になる場合があります。例えば、リソースディレクトリあるいはファイルに 660 ファイルアクセス許可があるとします。これは、このグループの所有者あるいはユーザーのみに読み取り (あるいは書き込み) アクセスがあることを意味します。この場合、このリソースに OS グループ所有者の権限を追加する必要があります。詳細については、「グループ所有者のファイルアクセス権限」を参照してください。
ホスト環境および Lambda 名前空間には、その両方に /proc ディレクトリがあるため、配置先パスを指定するときに名前の競合を回避するように注意します。例えば、/proc がソースパスの場合、/host-proc を配置先パスとして指定できます (または、「/proc」を除く任意のパス名)。
グループ所有者のファイルアクセス権限
AWS IoT Greengrass Lambda 関数プロセスは通常、ggc_user と ggc_group として実行されます。ただし、次のように、ローカルリソース定義の Lambda 関数プロセスに追加のファイルアクセス許可を与えることができます。
-
リソースを所有する Linux グループのアクセス権限を追加するには、
GroupOwnerSetting#AutoAddGroupOwnerパラメータまたは [Automatically add file system permissions of the system group that owns the resource] (リソースを所有するシステムグループのアクセス権限をファイルシステムに自動的に追加) コンソールオプションを使用します。 -
別の Linux グループのアクセス権限を追加するには、
GroupOwnerSetting#GroupOwnerパラメータまたは [Specify another system group to add file system permissions] (ファイルシステムの許可を追加するために、別のシステムグループを指定) コンソールオプションを使用します。GroupOwnerSetting#AutoAddGroupOwnerが true の場合、GroupOwner値は無視されます。
AWS IoT Greengrass Lambda 関数プロセスは、ggc_user、ggc_group および Linux グループ (追加されている場合) のすべてのファイルシステムアクセス許可を継承します。Lambda 関数がリソースにアクセスするためには、このリソースに要求されるアクセス許可が Lambda 関数プロセスにあることが必要です。必要に応じて、chmod(1) コマンドを使用して、リソースへのアクセス許可を変更できます。
以下も参照してください。
-
Amazon Web Services 全般のリファレンス 内のリソースの Service Quotas
