Bỏ qua để đến nội dung

Hướng dẫn Greengrass MQTT

Trong hướng dẫn này, bạn sẽ xây dựng một component AWS IoT Greengrass v2 bằng Python với @aws/nx-plugin, chạy nó trên một instance EC2 Ubuntu 26.04 x86_64 đóng vai trò là thiết bị lõi, và theo dõi nhịp tim của nó đến AWS IoT Core qua MQTT. Sau đó, bạn thay đổi mã nguồn, xuất bản phiên bản tiếp theo với NEXT_PATCH, xóa component khỏi thiết bị, và xóa mọi tài nguyên bạn đã tạo.

Hướng dẫn này sử dụng CDK và Greengrass nucleus cổ điển. Đối với các component TypeScript, Terraform, hoặc một fleet hiện có, hãy đọc hướng dẫn component Greengrass.

PhầnVị tríĐược tạo bởi
Dự án Python greengrass_tutorial.telemetrypackages/telemetrypy#project
Component com.example.Pulsepackages/telemetry/greengrass/pulsegreengrass#component
Các construct lõi Greengrass và construct ứng dụng Pulsepackages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrassgreengrass#component
Ứng dụng CDK @greengrass-tutorial/infrapackages/infrats#infra

Component được tạo ra xuất bản qua Greengrass IPC cục bộ. Module 1 thay đổi nó để xuất bản lên AWS IoT Core, điều này cần một thao tác IPC khác, một ủy quyền recipe khác, và một câu lệnh IoT policy trên thiết bị. Các tên API và kiểm soát truy cập đến từ tài liệu AWS IoT Core MQTT IPC.

Tài nguyênĐược tạo bởiĐược xóa bởi
IoT thing group, thing, certificate, IoT policy, token exchange role, role alias, IAM access policyScript thiết lập và trình cài đặt nucleusThao tác cleanup của script
Instance EC2 t3.small với SSM instance profileScript thiết lập (instance) và bạn (instance profile)Thao tác cleanup của script và bạn
Artifact bucket, component versions, deployment, artifact read grantStack CDK của bạndestroy, sau đó xóa thủ công bucket được giữ lại, versions và deployments

Instance chạy cho đến khi bạn dọn dẹp. Sử dụng một tài khoản AWS và Region mà bạn có thể dọn dẹp hoàn toàn.

  • Git
  • Node >= 22.13 (Chúng tôi khuyến nghị sử dụng công cụ như NVM để quản lý các phiên bản node của bạn)
    • xác minh bằng cách chạy node --version
  • UV >= 0.5.29
    1. cài đặt Python 3.14 bằng cách chạy: uv python install 3.14
    2. xác minh với uv python list --only-installed

Bạn cũng cần:

  • AWS CLI v2 với một profile được đặt tên cho tài khoản đích.
  • Quyền trong tài khoản đó để tạo IAM roles và policies, IoT things và policies, EC2 instances, Systems Manager commands, S3 buckets, CloudFormation stacks và Greengrass resources.
  • Một VPC mặc định trong Region, hoặc một subnet có quyền truy cập internet đi ra mà bạn truyền cho script thiết lập.

Mọi lệnh AWS CLI trong hướng dẫn này đều truyền --profile và --region một cách rõ ràng, và mọi lệnh CDK đều nhận AWS_PROFILE và AWS_REGION. Đặt các giá trị một lần trong shell của bạn:

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

TUTORIAL_PREFIX đặt tên cho mọi tài nguyên mà script thiết lập tạo ra. Chọn một giá trị mà không có gì khác trong tài khoản sử dụng.

Các lệnh, chỉnh sửa mã nguồn, build và CDK synthesis của hướng dẫn này được bao phủ bởi smoke test greengrass-tutorial trong CI. Hành vi identity, refusal và cleanup của script thiết lập chạy với một AWS CLI được ghi lại trong bộ test tài liệu.

Provisioning, MQTT delivery, device updates và cleanup yêu cầu một tài khoản AWS và vẫn nằm ngoài làn đường tự động. Làm theo các kiểm tra thiết bị trong mỗi module để xác minh deployment. Bảng hỗ trợ phần cứng ghi lại các nền tảng thiết bị được hỗ trợ.

  1. Tạo component: workspace, dự án Python, component, ứng dụng CDK, và chuyển sang AWS IoT Core MQTT.
  2. Cung cấp thiết bị lõi: instance profile, lựa chọn image, script thiết lập, và những gì nó tạo ra.
  3. Deploy, quan sát và cập nhật: stack CDK, deployment đầu tiên, nhịp tim MQTT, và bản cập nhật NEXT_PATCH.
  4. Xóa và dọn dẹp: một revision deployment trống, phá hủy stack, và xóa các tài nguyên được giữ lại và được tạo bởi script.