Tutorial Greengrass MQTT
In questo tutorial crei un componente Python AWS IoT Greengrass v2 con @aws/nx-plugin, lo esegui su un’istanza EC2 Ubuntu 26.04 x86_64 che funge da dispositivo core e osservi il suo heartbeat arrivare in AWS IoT Core tramite MQTT. Quindi modifichi il codice sorgente, pubblichi la versione successiva con NEXT_PATCH, rimuovi il componente dal dispositivo ed elimini ogni risorsa che hai creato.
Il tutorial utilizza CDK e il nucleus Greengrass classico. Per componenti TypeScript, Terraform o una flotta esistente, leggi la guida ai componenti Greengrass.
Cosa costruisci
Sezione intitolata “Cosa costruisci”| Elemento | Dove | Creato da |
|---|---|---|
Progetto Python greengrass_tutorial.telemetry | packages/telemetry | py#project |
Componente com.example.Pulse | packages/telemetry/greengrass/pulse | greengrass#component |
Costrutti core Greengrass e costrutto app Pulse | packages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrass | greengrass#component |
Applicazione CDK @greengrass-tutorial/infra | packages/infra | ts#infra |
Il componente generato pubblica tramite IPC Greengrass locale. Il modulo 1 lo modifica per pubblicare su AWS IoT Core, il che richiede un’operazione IPC diversa, un’autorizzazione recipe diversa e un’istruzione di policy IoT sul dispositivo. I nomi dell’API e del controllo degli accessi provengono dalla documentazione IPC MQTT di AWS IoT Core.
Cosa crea in AWS
Sezione intitolata “Cosa crea in AWS”| Risorsa | Creata da | Eliminata da |
|---|---|---|
| Gruppo di cose IoT, cosa, certificato, policy IoT, ruolo di scambio token, alias di ruolo, policy di accesso IAM | Lo script di setup e l’installer del nucleus | L’operazione cleanup dello script |
Istanza EC2 t3.small con un profilo di istanza SSM | Lo script di setup (istanza) e tu (profilo di istanza) | L’operazione cleanup dello script e tu |
| Bucket degli artefatti, versioni dei componenti, deployment, concessione di lettura degli artefatti | Il tuo stack CDK | destroy, quindi eliminazione manuale del bucket conservato, delle versioni e dei deployment |
L’istanza rimane in esecuzione fino a quando non esegui la pulizia. Utilizza un account AWS e una regione che puoi pulire completamente.
Prima di iniziare
Sezione intitolata “Prima di iniziare”- Git
- Node >= 22.13 (Consigliamo di utilizzare qualcosa come NVM per gestire le versioni di node)
- verifica eseguendo
node --version
- verifica eseguendo
- UV >= 0.5.29
- installa Python 3.14 eseguendo:
uv python install 3.14 - verifica con
uv python list --only-installed
- installa Python 3.14 eseguendo:
Hai anche bisogno di:
- AWS CLI v2 con un profilo denominato per l’account di destinazione.
- Permessi in quell’account per creare ruoli e policy IAM, cose e policy IoT, istanze EC2, comandi Systems Manager, bucket S3, stack CloudFormation e risorse Greengrass.
- Un VPC predefinito nella regione, o una subnet con accesso internet in uscita che passi allo script di setup.
Ogni comando AWS CLI in questo tutorial passa --profile e --region esplicitamente, e ogni comando CDK riceve AWS_PROFILE e AWS_REGION. Imposta i valori una volta nella tua shell:
export TUTORIAL_AWS_PROFILE=<your-profile>export TUTORIAL_AWS_REGION=us-east-1export TUTORIAL_PREFIX=gg-tutorialTUTORIAL_PREFIX nomina ogni risorsa creata dallo script di setup. Scegli un valore che nient’altro nell’account utilizza.
Cosa viene verificato automaticamente
Sezione intitolata “Cosa viene verificato automaticamente”I comandi, le modifiche al codice sorgente, la build e la sintesi CDK di questo tutorial sono coperti dal test smoke greengrass-tutorial in CI. Il comportamento di identità, rifiuto e pulizia dello script di setup viene eseguito contro un AWS CLI registrato nella suite di test della documentazione.
Il provisioning, la consegna MQTT, gli aggiornamenti del dispositivo e la pulizia richiedono un account AWS e rimangono al di fuori della corsia automatizzata. Segui i controlli del dispositivo in ogni modulo per verificare il deployment. La tabella di supporto hardware registra le piattaforme di dispositivi supportate.
- Crea il componente: workspace, progetto Python, componente, applicazione CDK e il passaggio a AWS IoT Core MQTT.
- Effettua il provisioning del dispositivo core: profilo di istanza, selezione dell’immagine, lo script di setup e cosa crea.
- Distribuisci, osserva e aggiorna: lo stack CDK, il primo deployment, l’heartbeat MQTT e un aggiornamento
NEXT_PATCH. - Rimuovi e pulisci: una revisione di deployment vuota, distruzione dello stack ed eliminazione delle risorse conservate e create dallo script.