Salta ai contenuti

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.

ElementoDoveCreato da
Progetto Python greengrass_tutorial.telemetrypackages/telemetrypy#project
Componente com.example.Pulsepackages/telemetry/greengrass/pulsegreengrass#component
Costrutti core Greengrass e costrutto app Pulsepackages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrassgreengrass#component
Applicazione CDK @greengrass-tutorial/infrapackages/infrats#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.

RisorsaCreata daEliminata da
Gruppo di cose IoT, cosa, certificato, policy IoT, ruolo di scambio token, alias di ruolo, policy di accesso IAMLo script di setup e l’installer del nucleusL’operazione cleanup dello script
Istanza EC2 t3.small con un profilo di istanza SSMLo 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 artefattiIl tuo stack CDKdestroy, 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.

  • Git
  • Node >= 22.13 (Consigliamo di utilizzare qualcosa come NVM per gestire le versioni di node)
    • verifica eseguendo node --version
  • UV >= 0.5.29
    1. installa Python 3.14 eseguendo: uv python install 3.14
    2. verifica con uv python list --only-installed

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:

Finestra del terminale
export TUTORIAL_AWS_PROFILE=<your-profile>
export TUTORIAL_AWS_REGION=us-east-1
export TUTORIAL_PREFIX=gg-tutorial

TUTORIAL_PREFIX nomina ogni risorsa creata dallo script di setup. Scegli un valore che nient’altro nell’account utilizza.

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.

  1. Crea il componente: workspace, progetto Python, componente, applicazione CDK e il passaggio a AWS IoT Core MQTT.
  2. Effettua il provisioning del dispositivo core: profilo di istanza, selezione dell’immagine, lo script di setup e cosa crea.
  3. Distribuisci, osserva e aggiorna: lo stack CDK, il primo deployment, l’heartbeat MQTT e un aggiornamento NEXT_PATCH.
  4. Rimuovi e pulisci: una revisione di deployment vuota, distruzione dello stack ed eliminazione delle risorse conservate e create dallo script.