Greengrass MQTTチュートリアル
このチュートリアルでは、@aws/nx-pluginを使用してPython AWS IoT Greengrass v2コンポーネントを構築し、コアデバイスとして機能するUbuntu 26.04 x86_64 EC2インスタンス上で実行し、MQTT経由でAWS IoT Coreにハートビートが到着するのを確認します。その後、ソースを変更し、NEXT_PATCHで次のバージョンを公開し、デバイスからコンポーネントを削除し、作成したすべてのリソースを削除します。
このチュートリアルでは、CDKとクラシックGreengrass nucleusを使用します。TypeScriptコンポーネント、Terraform、または既存のフリートについては、Greengrassコンポーネントガイドをお読みください。
構築するもの
Section titled “構築するもの”| 項目 | 場所 | 作成者 |
|---|---|---|
Pythonプロジェクト greengrass_tutorial.telemetry | packages/telemetry | py#project |
コンポーネント com.example.Pulse | packages/telemetry/greengrass/pulse | greengrass#component |
GreengrassコアコンストラクトとPulseアプリコンストラクト | packages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrass | greengrass#component |
CDKアプリケーション @greengrass-tutorial/infra | packages/infra | ts#infra |
生成されたコンポーネントは、ローカルGreengrass IPC経由で公開します。モジュール1では、AWS IoT Coreに公開するように変更します。これには、異なるIPC操作、異なるレシピ認可、およびデバイス上のIoTポリシーステートメントが必要です。APIとアクセス制御の名前は、AWS IoT Core MQTT IPCドキュメントから取得されています。
AWSで作成されるもの
Section titled “AWSで作成されるもの”| リソース | 作成者 | 削除者 |
|---|---|---|
| IoTシンググループ、シング、証明書、IoTポリシー、トークン交換ロール、ロールエイリアス、IAMアクセスポリシー | セットアップスクリプトとnucleusインストーラー | スクリプトのcleanup操作 |
SSMインスタンスプロファイルを持つEC2 t3.smallインスタンス | セットアップスクリプト(インスタンス)とあなた(インスタンスプロファイル) | スクリプトのcleanup操作とあなた |
| アーティファクトバケット、コンポーネントバージョン、デプロイメント、アーティファクト読み取り権限 | あなたのCDKスタック | destroy、その後保持されたバケット、バージョン、デプロイメントの手動削除 |
インスタンスはクリーンアップするまで実行されます。完全にクリーンアップできるAWSアカウントとリージョンを使用してください。
- Git
- Node >= 22.13 (NVM のようなツールを使用してノードバージョンを管理することをお勧めします)
node --versionを実行して確認してください
- UV >= 0.5.29
uv python install 3.14を実行して Python 3.14 をインストールしますuv python list --only-installedで確認してください
また、以下も必要です:
- ターゲットアカウント用の名前付きプロファイルを持つAWS CLI v2。
- そのアカウントでIAMロールとポリシー、IoTシングとポリシー、EC2インスタンス、Systems Managerコマンド、S3バケット、CloudFormationスタック、Greengrassリソースを作成する権限。
- リージョン内のデフォルトVPC、またはセットアップスクリプトに渡すアウトバウンドインターネットアクセスを持つサブネット。
このチュートリアルのすべてのAWS CLIコマンドは--profileと--regionを明示的に渡し、すべてのCDKコマンドはAWS_PROFILEとAWS_REGIONを受け取ります。シェルで一度値を設定してください:
export TUTORIAL_AWS_PROFILE=<your-profile>export TUTORIAL_AWS_REGION=us-east-1export TUTORIAL_PREFIX=gg-tutorialTUTORIAL_PREFIXは、セットアップスクリプトが作成するすべてのリソースに名前を付けます。アカウント内の他のものが使用していない値を選択してください。
自動的に検証されるもの
Section titled “自動的に検証されるもの”このチュートリアルのコマンド、ソース編集、ビルド、CDK合成は、CIのgreengrass-tutorialスモークテストでカバーされています。セットアップスクリプトのID、拒否、クリーンアップの動作は、docsテストスイートで記録されたAWS CLIに対して実行されます。
プロビジョニング、MQTT配信、デバイス更新、クリーンアップにはAWSアカウントが必要であり、自動化レーンの外に残ります。各モジュールのデバイスチェックに従ってデプロイメントを検証してください。ハードウェアサポートテーブルには、サポートされているデバイスプラットフォームが記録されています。
- コンポーネントの作成:ワークスペース、Pythonプロジェクト、コンポーネント、CDKアプリケーション、およびAWS IoT Core MQTTへの切り替え。
- コアデバイスのプロビジョニング:インスタンスプロファイル、イメージ選択、セットアップスクリプト、およびそれが作成するもの。
- デプロイ、観察、更新:CDKスタック、最初のデプロイメント、MQTTハートビート、および
NEXT_PATCH更新。 - 削除とクリーンアップ:空のデプロイメントリビジョン、スタックの破棄、および保持されたリソースとスクリプトで作成されたリソースの削除。