Skip to content

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コンポーネントガイドをお読みください。

項目場所作成者
Pythonプロジェクト greengrass_tutorial.telemetrypackages/telemetrypy#project
コンポーネント com.example.Pulsepackages/telemetry/greengrass/pulsegreengrass#component
GreengrassコアコンストラクトとPulseアプリコンストラクトpackages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrassgreengrass#component
CDKアプリケーション @greengrass-tutorial/infrapackages/infrats#infra

生成されたコンポーネントは、ローカルGreengrass IPC経由で公開します。モジュール1では、AWS IoT Coreに公開するように変更します。これには、異なるIPC操作、異なるレシピ認可、およびデバイス上のIoTポリシーステートメントが必要です。APIとアクセス制御の名前は、AWS IoT Core MQTT IPCドキュメントから取得されています。

リソース作成者削除者
IoTシンググループ、シング、証明書、IoTポリシー、トークン交換ロール、ロールエイリアス、IAMアクセスポリシーセットアップスクリプトとnucleusインストーラースクリプトのcleanup操作
SSMインスタンスプロファイルを持つEC2 t3.smallインスタンスセットアップスクリプト(インスタンス)とあなた(インスタンスプロファイル)スクリプトのcleanup操作とあなた
アーティファクトバケット、コンポーネントバージョン、デプロイメント、アーティファクト読み取り権限あなたのCDKスタックdestroy、その後保持されたバケット、バージョン、デプロイメントの手動削除

インスタンスはクリーンアップするまで実行されます。完全にクリーンアップできるAWSアカウントとリージョンを使用してください。

  • Git
  • Node >= 22.13 (NVM のようなツールを使用してノードバージョンを管理することをお勧めします)
    • node --version を実行して確認してください
  • UV >= 0.5.29
    1. uv python install 3.14 を実行して Python 3.14 をインストールします
    2. 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を受け取ります。シェルで一度値を設定してください:

Terminal window
export TUTORIAL_AWS_PROFILE=<your-profile>
export TUTORIAL_AWS_REGION=us-east-1
export TUTORIAL_PREFIX=gg-tutorial

TUTORIAL_PREFIXは、セットアップスクリプトが作成するすべてのリソースに名前を付けます。アカウント内の他のものが使用していない値を選択してください。

このチュートリアルのコマンド、ソース編集、ビルド、CDK合成は、CIのgreengrass-tutorialスモークテストでカバーされています。セットアップスクリプトのID、拒否、クリーンアップの動作は、docsテストスイートで記録されたAWS CLIに対して実行されます。

プロビジョニング、MQTT配信、デバイス更新、クリーンアップにはAWSアカウントが必要であり、自動化レーンの外に残ります。各モジュールのデバイスチェックに従ってデプロイメントを検証してください。ハードウェアサポートテーブルには、サポートされているデバイスプラットフォームが記録されています。

  1. コンポーネントの作成:ワークスペース、Pythonプロジェクト、コンポーネント、CDKアプリケーション、およびAWS IoT Core MQTTへの切り替え。
  2. コアデバイスのプロビジョニング:インスタンスプロファイル、イメージ選択、セットアップスクリプト、およびそれが作成するもの。
  3. デプロイ、観察、更新:CDKスタック、最初のデプロイメント、MQTTハートビート、およびNEXT_PATCH更新。
  4. 削除とクリーンアップ:空のデプロイメントリビジョン、スタックの破棄、および保持されたリソースとスクリプトで作成されたリソースの削除。