Tutorial de Greengrass MQTT
En este tutorial construyes un componente Python de AWS IoT Greengrass v2 con @aws/nx-plugin, lo ejecutas en una instancia EC2 Ubuntu 26.04 x86_64 que actúa como dispositivo central, y observas cómo llega su latido a AWS IoT Core a través de MQTT. Luego cambias el código fuente, publicas la siguiente versión con NEXT_PATCH, eliminas el componente del dispositivo y borras todos los recursos que creaste.
El tutorial utiliza CDK y el núcleo clásico de Greengrass. Para componentes TypeScript, Terraform o una flota existente, lee la guía de componentes de Greengrass.
Qué construyes
Sección titulada «Qué construyes»| Pieza | Dónde | Creado por |
|---|---|---|
Proyecto Python greengrass_tutorial.telemetry | packages/telemetry | py#project |
Componente com.example.Pulse | packages/telemetry/greengrass/pulse | greengrass#component |
Construcciones del núcleo de Greengrass y la construcción de la aplicación Pulse | packages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrass | greengrass#component |
Aplicación CDK @greengrass-tutorial/infra | packages/infra | ts#infra |
El componente generado publica a través de IPC local de Greengrass. El módulo 1 lo cambia para publicar en AWS IoT Core, lo cual requiere una operación IPC diferente, una autorización de receta diferente y una declaración de política IoT en el dispositivo. Los nombres de la API y del control de acceso provienen de la documentación de IPC MQTT de AWS IoT Core.
Qué crea en AWS
Sección titulada «Qué crea en AWS»| Recurso | Creado por | Eliminado por |
|---|---|---|
| Grupo de cosas IoT, cosa, certificado, política IoT, rol de intercambio de tokens, alias de rol, política de acceso IAM | El script de configuración y el instalador del núcleo | La operación cleanup del script |
Instancia EC2 t3.small con un perfil de instancia SSM | El script de configuración (instancia) y tú (perfil de instancia) | La operación cleanup del script y tú |
| Bucket de artefactos, versiones de componentes, despliegue, concesión de lectura de artefactos | Tu stack de CDK | destroy, luego eliminación manual del bucket retenido, versiones y despliegues |
La instancia se ejecuta hasta que la limpies. Usa una cuenta de AWS y una región que puedas limpiar completamente.
Antes de comenzar
Sección titulada «Antes de comenzar»- Git
- Node >= 22.13 (Recomendamos usar algo como NVM para gestionar tus versiones de node)
- verifica ejecutando
node --version
- verifica ejecutando
- UV >= 0.5.29
- instala Python 3.14 ejecutando:
uv python install 3.14 - verifica con
uv python list --only-installed
- instala Python 3.14 ejecutando:
También necesitas:
- AWS CLI v2 con un perfil nombrado para la cuenta de destino.
- Permisos en esa cuenta para crear roles y políticas IAM, cosas y políticas IoT, instancias EC2, comandos de Systems Manager, buckets S3, stacks de CloudFormation y recursos de Greengrass.
- Una VPC predeterminada en la región, o una subred con acceso a internet saliente que pases al script de configuración.
Cada comando de AWS CLI en este tutorial pasa --profile y --region explícitamente, y cada comando CDK recibe AWS_PROFILE y AWS_REGION. Establece los valores una vez en tu shell:
export TUTORIAL_AWS_PROFILE=<your-profile>export TUTORIAL_AWS_REGION=us-east-1export TUTORIAL_PREFIX=gg-tutorialTUTORIAL_PREFIX nombra cada recurso que crea el script de configuración. Elige un valor que nada más en la cuenta utilice.
Qué se verifica automáticamente
Sección titulada «Qué se verifica automáticamente»Los comandos, ediciones de código fuente, compilación y síntesis de CDK de este tutorial están cubiertos por la prueba de humo greengrass-tutorial en CI. El comportamiento de identidad, rechazo y limpieza del script de configuración se ejecuta contra un AWS CLI grabado en el conjunto de pruebas de documentación.
El aprovisionamiento, la entrega MQTT, las actualizaciones del dispositivo y la limpieza requieren una cuenta de AWS y permanecen fuera del carril automatizado. Sigue las verificaciones del dispositivo en cada módulo para verificar el despliegue. La tabla de soporte de hardware registra las plataformas de dispositivos compatibles.
Módulos
Sección titulada «Módulos»- Crear el componente: espacio de trabajo, proyecto Python, componente, aplicación CDK y el cambio a AWS IoT Core MQTT.
- Aprovisionar el dispositivo central: perfil de instancia, selección de imagen, el script de configuración y qué crea.
- Desplegar, observar y actualizar: el stack de CDK, el primer despliegue, el latido MQTT y una actualización
NEXT_PATCH. - Eliminar y limpiar: una revisión de despliegue vacía, destrucción del stack y eliminación de los recursos retenidos y creados por el script.