Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1 Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Nozioni di base sui connettori Greengrass (console) Questa funzionalità è disponibile per AWS IoT Greengrass Core v1.7 e versioni successive. Questo tutorial mostra come utilizzarlo per Console di gestione AWS lavorare con i connettori. Utilizza i connettori per accelerare il ciclo di vita dello sviluppo. I connettori sono moduli precostituiti e riutilizzabili che semplificano l'interazione con servizi, protocolli e risorse. Possono aiutarti a distribuire più rapidamente la logica di business ai dispositivi Greengrass. Per ulteriori informazioni, consulta [Integrazione con servizi e protocolli tramite i connettori Greengrass](connectors.md). In questo tutorial, configuri e distribuisci il connettore [Twilio Notifications](twilio-notifications-connector.md). Il connettore riceve le informazioni sui messaggi Twilio come dati di input, quindi attiva un messaggio di testo Twilio. Il flusso di dati viene mostrato nel seguente schema. ![\[Flusso di dati dalla funzione Lambda al connettore Twilio Notifications a Twilio.\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/images/connectors/twilio-solution.png) Dopo aver configurato il connettore, crei una funzione Lambda e un abbonamento. + La funzione valuta i dati simulati da un sensore di temperatura. Pubblica in base a condizioni le informazioni sul messaggio Twilio in un argomento MQTT. Questo è l'argomento a cui il connettore effettua la sottoscrizione. + La sottoscrizione consente alla funzione di effettuare la pubblicazione nell'argomento e al connettore di ricevere i dati dall'argomento. Il connettore Twilio Notifications richiede un token di autenticazione Twilio per interagire con l'API Twilio. Il token è un tipo di testo segreto creato Gestione dei segreti AWS e referenziato da una risorsa di gruppo. Ciò consente di AWS IoT Greengrass creare una copia locale del segreto sul core di Greengrass, dove viene crittografato e reso disponibile al connettore. Per ulteriori informazioni, consulta [Implementa i segreti fino al nucleo AWS IoT Greengrass](secrets.md). Il tutorial include le seguenti fasi di alto livello: 1. [Crea un segreto di Secrets Manager](#connectors-console-create-secret) 1. [Aggiunta di una risorsa segreta a un gruppo](#connectors-console-create-resource) 1. [Aggiunta di un connettore al gruppo](#connectors-console-create-connector) 1. [Creare un pacchetto di distribuzione della funzione Lambda](#connectors-console-create-deployment-package) 1. [Creazione di una funzione Lambda ](#connectors-console-create-function) 1. [Aggiunta di una funzione al gruppo](#connectors-console-create-gg-function) 1. [Aggiunta di sottoscrizioni al gruppo](#connectors-console-create-subscription) 1. [Distribuzione del gruppo.](#connectors-console-create-deployment) 1. [Test della soluzione](#connectors-console-test-solution) Il completamento di questo tutorial richiede circa 20 minuti. ## Prerequisiti Per completare questo tutorial, è necessario quanto segue: + Un gruppo Greengrass e un core Greengrass (v1.9.3 or later). Per informazioni su come creare un gruppo e un core Greengrass, consulta [Iniziare con AWS IoT Greengrass](gg-gs.md). Nel tutorial Nozioni di base sono descritte anche le fasi per l'installazione del software AWS IoT Greengrass Core. + Python 3.7 installato sul dispositivo principale AWS IoT Greengrass . + AWS IoT Greengrass deve essere configurato per supportare i segreti locali, come descritto in [Secrets](secrets.md#secrets-reqs) Requirements. **Nota** Questo requisito include l'autorizzazione all'accesso ai segreti di Secrets Manager. *Se utilizzi il ruolo di servizio Greengrass predefinito, Greengrass è autorizzato a ottenere i valori dei segreti con nomi che iniziano con greengrass-.* + SID dell'account Twilio, token di autorizzazione e numero di telefono abilitato per Twilio. Dopo avere creato un progetto Twilio, questi valori sono disponibili nel pannello di controllo del progetto. **Nota** Puoi utilizzare un account di prova Twilio. Se utilizzi un account di prova, devi aggiungere i numeri di telefono dei destinatari diversi da Twilio a un elenco di numeri di telefono verificati. Per ulteriori informazioni, vedi [Come lavorare con il tuo account di prova Twilio gratuito](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account). ## Fase 1: Creare un segreto di Secrets Manager In questo passaggio, utilizzi la Gestione dei segreti AWS console per creare un tipo di testo segreto per il tuo token di autenticazione Twilio. 1. Accedi alla [console Gestione dei segreti AWS](https://console.aws.amazon.com/secretsmanager/). **Nota** Per ulteriori informazioni su questo processo, consulta [Fase 1: Creare e archiviare il segreto Gestione dei segreti AWS nella Guida](https://docs.aws.amazon.com/secretsmanager/latest/userguide/tutorials_basic.html) per l'*Gestione dei segreti AWS utente*. 1. Scegli **Archivia un nuovo segreto**. 1. In **Scegli il tipo di segreto**, scegli **Altro tipo di segreto**. 1. In **Specificare le key/value coppie da archiviare per questo segreto**, nella scheda **Plaintext**, inserisci il tuo token di autenticazione Twilio. Rimuovi tutta la formattazione JSON e immetti solo il valore del token. 1. **Mantieni **aws/secretsmanager** selezionato per la chiave di crittografia, quindi scegli Avanti.** **Nota** Non ti viene addebitato alcun costo AWS KMS se utilizzi la chiave AWS gestita predefinita creata da Secrets Manager nel tuo account. 1. In **Secret name (Nome segreto)**, immetti **greengrass-TwilioAuthToken**, quindi seleziona **Next (Avanti)**. **Nota** Per impostazione predefinita, il ruolo di servizio Greengrass consente di AWS IoT Greengrass ottenere il valore dei segreti con nomi che iniziano con *greengrass* -. Per ulteriori informazioni, consulta [Requisiti dei segreti](secrets.md#secrets-reqs). 1. **Questo tutorial non richiede la rotazione, quindi scegli disabilita la rotazione automatica, quindi scegli Avanti.** 1. Nella pagina **Review (Revisione)**, rivedi le impostazioni e quindi scegli **Store (Archivia)**. Dovrai quindi creare una risorsa segreta nel gruppo Greengrass che faccia riferimento al segreto. ## Fase 2: aggiunta di una risorsa segreta a un gruppo Greengrass In questa fase, aggiungerai una *risorsa segreta* al gruppo Greengrass. Questa risorsa è un riferimento al segreto creato nella fase precedente. 1. Nel riquadro di navigazione della AWS IoT console, in **Gestione**, espandi **i dispositivi Greengrass**, quindi scegli **Gruppi (V1**). 1. Scegli il gruppo a cui aggiungere la risorsa segreta. 1. Nella pagina di configurazione del gruppo, scegli la scheda **Risorse**, quindi scorri verso il basso fino alla sezione **Segreti**. La sezione **Segreti** mostra le risorse segrete che appartengono al gruppo. È possibile aggiungere, modificare e rimuovere risorse segrete da questa sezione. **Nota** In alternativa, la console consente di creare una risorsa segreta e segreta quando si configura un connettore o una funzione Lambda. È possibile eseguire questa operazione dalla pagina **Configura parametri** del connettore o dalla pagina **Risorse** della funzione Lambda. 1. Scegli **Aggiungi** nella sezione **Segreti**. 1. Nella pagina **Aggiungi una risorsa segreta**, inserisci **MyTwilioAuthToken** il **nome della risorsa**. 1. Per il **Segreto**, scegli **greengrass-. TwilioAuthToken** 1. Nella sezione **Seleziona etichette (opzionale)**, l'etichetta AWSCURRENT staging rappresenta la versione più recente del segreto. Questa etichetta è sempre inclusa in una risorsa segreta. **Nota** Questo tutorial richiede solo l' AWSCURRENT etichetta. Facoltativamente, puoi includere le etichette richieste dalla funzione o dal connettore Lambda. 1. Scegliere **Add resource (Aggiungi risorsa)**. ## Fase 3: aggiunta di un connettore al gruppo Greengrass In questo passaggio, configuri i parametri per il [connettore Twilio Notifications](twilio-notifications-connector.md) e lo aggiungi al gruppo. 1. Nella pagina di configurazione del gruppo, scegliere **Connectors (Connettori)**, quindi **Add a connector (Aggiungi un connettore)**. 1. Nella pagina **Aggiungi connettore**, scegli Notifiche **Twilio**. 1. Scegliere la versione . 1. Nella sezione **Configurazione**: + Per la **risorsa del token di autenticazione Twilio**, inserisci la risorsa che hai creato nel passaggio precedente. **Nota** Quando si immette la risorsa, l'**ARN della proprietà segreta del token di autenticazione Twilio** viene compilato automaticamente. + In **Default from phone number (Impostazione predefinita da numero di telefono)**, immettere il numero di telefono abilitato per Twilio. + In **Twilio account SID (SID account Twilio)**, immettere il SID dell'account Twilio. 1. Scegliere **Add resource (Aggiungi risorsa)**. ## Fase 4: Creare un pacchetto di distribuzione della funzione Lambda Per creare una funzione Lambda, devi prima creare un *pacchetto di distribuzione* della funzione Lambda che contenga il codice della funzione e le dipendenze. Le funzioni Greengrass Lambda richiedono il [AWS IoT Greengrass Core SDK](lambda-functions.md#lambda-sdks-core) per attività come la comunicazione con i messaggi MQTT nell'ambiente principale e l'accesso ai segreti locali. Questo tutorial crea una funzione Python, quindi utilizzi la versione Python dell'SDK nel pacchetto di distribuzione. 1. Dalla pagina dei download di [AWS IoT Greengrass Core SDK](what-is-gg.md#gg-core-sdk-download), scarica AWS IoT Greengrass Core SDK per Python sul tuo computer. 1. Decomprimere il pacchetto scaricato per ottenere l'SDK. Il kit SDK è la cartella `greengrasssdk`. 1. Salvare la seguente funzione del codice Python nel file locale `temp_monitor.py`. ``` import greengrasssdk import json import random client = greengrasssdk.client('iot-data') # publish to the Twilio Notifications connector through the twilio/txt topic def function_handler(event, context): temp = event['temperature'] # check the temperature # if greater than 30C, send a notification if temp > 30: data = build_request(event) client.publish(topic='twilio/txt', payload=json.dumps(data)) print('published:' + str(data)) print('temperature:' + str(temp)) return # build the Twilio request from the input data def build_request(event): to_name = event['to_name'] to_number = event['to_number'] temp_report = 'temperature:' + str(event['temperature']) return { "request": { "recipient": { "name": to_name, "phone_number": to_number, "message": temp_report } }, "id": "request_" + str(random.randint(1,101)) } ``` 1. Comprimere le voci seguenti nel file `temp_monitor_python.zip`. Al momento della creazione del file ZIP, includere solo il codice e le dipendenze, non la cartella che li contiene. + **temp\$1monitor.py**. La logica dell'app. + **greengrasssdk**. Libreria richiesta per le funzioni Python Greengrass Lambda che pubblicano messaggi MQTT. Questo è il tuo pacchetto di implementazione della funzione Lambda. Ora, crea una funzione Lambda che utilizzi il pacchetto di distribuzione. ## Fase 5: Creare una funzione Lambda nella console AWS Lambda In questo passaggio, si utilizza la AWS Lambda console per creare una funzione Lambda e configurarla per utilizzare il pacchetto di distribuzione. In seguito, pubblicherai una versione della funzione e creerai un alias. 1. Innanzitutto, crea la funzione Lambda. 1. In Console di gestione AWS, scegli **Servizi** e apri la AWS Lambda console. 1. Scegli **Crea funzione**, quindi scegli **Autore da zero**. 1. Nella sezione **Basic information (Informazioni di base)**, specifica i seguenti valori: + Nel campo **Function name (Nome funzione)**, immettere **TempMonitor**. + In **Runtime**, scegliere **Python 3.7**. + Per **le autorizzazioni**, mantieni l'impostazione predefinita. Questo crea un ruolo di esecuzione che concede le autorizzazioni Lambda di base. Questo ruolo non viene utilizzato da. AWS IoT Greengrass 1. Nella parte inferiore della pagina, scegli **Crea funzione**. 1. Quindi, registra il gestore e carica il pacchetto di distribuzione della funzione Lambda. 1. Nella scheda **Codice**, in **Codice sorgente**, scegli **Carica** da. Dal menu a discesa, scegli un **file.zip.** ![\[Il menu a discesa Carica da con il file.zip evidenziato.\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/images/lra-console/upload-deployment-package.png) 1. Scegli **Carica**, quindi scegli il pacchetto di `temp_monitor_python.zip` distribuzione. Poi, scegli **Salva**. 1. Nella scheda **Codice** della funzione, in **Impostazioni di runtime**, scegliete **Modifica**, quindi immettete i seguenti valori. + In **Runtime**, scegliere **Python 3.7**. + In **Handler (Gestore)**, immetti **temp\$1monitor.function\$1handler** 1. Scegli **Save** (Salva). **Nota** Il pulsante **Test** sulla AWS Lambda console non funziona con questa funzione. Il AWS IoT Greengrass Core SDK non contiene moduli necessari per eseguire le funzioni Greengrass Lambda in modo indipendente nella console. AWS Lambda Questi moduli (ad esempio,`greengrass_common`) vengono forniti alle funzioni dopo essere stati distribuiti nel core Greengrass. 1. Ora, pubblica la prima versione della tua funzione Lambda e crea un [alias per la](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html) versione. **Nota** I gruppi Greengrass possono fare riferimento a una funzione Lambda tramite alias (consigliato) o per versione. L'utilizzo di un alias semplifica la gestione degli aggiornamenti del codice perché non è necessario modificare la tabella di sottoscrizione o la definizione del gruppo quando il codice della funzione viene aggiornato. Invece, è sufficiente indirizzare l'alias alla nuova versione della funzione. 1. Nel menu **Actions (Operazioni)**, seleziona **Publish new version (Pubblica nuova versione)**. 1. Per **Version description (Descrizione versione)**, immettere **First version**, quindi scegliere **Publish (Pubblica)**. 1. Nella pagina di configurazione **TempMonitor: 1**, dal menu **Azioni**, scegli **Crea alias**. 1. Nella pagina **Create a new alias (Crea un nuovo alias)**, utilizza i seguenti valori: + In **Nome**, inserisci **GG\$1TempMonitor**. + In **Version (Versione)**, selezionare **1**. **Nota** AWS IoT Greengrass **non supporta gli alias Lambda per le versioni \$1LATEST.** 1. Scegli **Create** (Crea). Ora sei pronto per aggiungere la funzione Lambda al tuo gruppo Greengrass. ## Fase 6: Aggiungere una funzione Lambda al gruppo Greengrass In questo passaggio, aggiungi la funzione Lambda al gruppo e quindi configuri il ciclo di vita e le variabili di ambiente. Per ulteriori informazioni, consulta [Controllo dell'esecuzione delle funzioni Greengrass Lambda utilizzando la configurazione specifica del gruppo](lambda-group-config.md). 1. Nella pagina di configurazione del gruppo, scegli la scheda **Funzioni Lambda**. 1. **In **Funzioni My Lambda**, scegli Aggiungi.** 1. Nella pagina **Aggiungi funzione Lambda, scegli **TempMonitor**la tua funzione** Lambda. 1. Per la **versione della funzione Lambda**, scegli **Alias**: GG\$1. TempMonitor 1. Scegli **Aggiungi funzione Lambda**. ## Fase 7: aggiunta di sottoscrizioni al gruppo Greengrass In questo passaggio, aggiungi un abbonamento che consente alla funzione Lambda di inviare dati di input al connettore. Il connettore definisce gli argomenti MQTT a cui è sottoscritto. Pertanto, questa sottoscrizione utilizza uno degli argomenti. Si tratta dello argomento in cui la funzione di esempio effettua la pubblicazione. Per questo tutorial, creerai anche abbonamenti che consentono alla funzione di ricevere letture simulate della temperatura AWS IoT e di AWS IoT ricevere informazioni sullo stato dal connettore. 1. **Nella pagina di configurazione del gruppo, scegli la scheda **Abbonamenti**, quindi scegli Aggiungi abbonamento.** 1. Nella pagina **Crea un abbonamento**, configura l'origine e la destinazione come segue: 1. Per **Tipo di sorgente**, scegli la **funzione Lambda**, quindi scegli. **TempMonitor** 1. Per **Tipo di destinazione**, scegli **Connettore**, quindi scegli Notifiche **Twilio**. 1. Per il **filtro Argomento**, scegli**twilio/txt**. 1. Scegli **Create Subscription** (Crea sottoscrizione). 1. Ripeti i passaggi da 1 a 4 per creare un abbonamento che AWS IoT consenta di pubblicare messaggi sulla funzione. 1. Per **Tipo di origine**, scegli **Servizio**, quindi scegli **IoT Cloud**. 1. Per **Seleziona un obiettivo**, scegli **Funzione Lambda**, quindi scegli. **TempMonitor** 1. In **Topic filter (Filtro argomento)**, immettere **temperature/input**. 1. Ripetere le fasi da 1 a 4 per creare una sottoscrizione che consenta al connettore di pubblicare messaggi in AWS IoT. 1. Per **Tipo di sorgente**, scegli **Connettore**, quindi scegli Notifiche **Twilio**. 1. Per il **tipo di Target**, scegli **Service**, quindi scegli **IoT Cloud**. 1. In **Topic filter (Filtro argomento)**, viene inserito **twilio/message/status**. Si tratta dell'argomento predefinito in cui pubblica il connettore. ## Fase 8: distribuzione del gruppo Greengrass Distribuire il gruppo al nuovo dispositivo core. 1. Assicurati che il AWS IoT Greengrass core sia in funzione. Esegui i seguenti comandi nel terminale di Raspberry Pi in base alle esigenze. 1. Per controllare se il daemon è in esecuzione: ``` ps aux | grep -E 'greengrass.*daemon' ``` Se l'output contiene una voce `root` per `/greengrass/ggc/packages/ggc-version/bin/daemon`, allora il daemon è in esecuzione. **Nota** La versione indicata nel percorso dipende dalla versione del software AWS IoT Greengrass Core installata sul dispositivo principale. 1. Per avviare il demone: ``` cd /greengrass/ggc/core/ sudo ./greengrassd start ``` 1. **Nella pagina di configurazione del gruppo, scegli Deploy.** 1. 1. **Nella scheda **Funzioni Lambda, nella sezione Funzioni** **System Lambda**, seleziona **Rilevatore IP** e scegli Modifica.** 1. Nella finestra di dialogo **Modifica impostazioni del rilevatore IP**, seleziona Rileva **e sostituisci automaticamente gli endpoint del broker MQTT**. 1. Scegli **Save** (Salva). Questo consente ai dispositivi di acquisire automaticamente informazioni di base sulla connettività, come, ad esempio indirizzo IP, DNS e numero della porta. Il rilevamento automatico è consigliato, ma supporta AWS IoT Greengrass anche gli endpoint specificati manualmente. Ti viene chiesto il metodo di individuazione solo la prima volta che il gruppo viene distribuito. **Nota** Se richiesto, concedi l'autorizzazione a creare il ruolo di [servizio Greengrass](service-role.md) e associarlo al Account AWS tuo ruolo attuale. Regione AWS Questo ruolo consente di accedere AWS IoT Greengrass alle tue risorse nei AWS servizi. Nella pagina **Deployments (Distribuzioni)** vengono visualizzati il timestamp della distribuzione, l'ID versione e lo stato. Una volta completata, lo stato visualizzato per la distribuzione dovrebbe essere **Completato**. Per la risoluzione dei problemi, consultare [Risoluzione dei problemi AWS IoT Greengrass](gg-troubleshooting.md). **Nota** Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta [Aggiornamento delle versioni dei connettori](connectors.md#upgrade-connector-versions). ## Test della soluzione 1. Nella home page della AWS IoT console, scegli **Test**. 1. Per **Sottoscrivi all'argomento**, utilizza i seguenti valori, quindi scegli **Sottoscrivi**. Il connettore Twilio Notifications pubblica informazioni sullo stato di questo argomento. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/connectors-console.html) 1. **Per Pubblica su argomento**, utilizzate i seguenti valori, quindi scegliete **Pubblica** per richiamare la funzione. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v1/developerguide/connectors-console.html) Se l'operazione viene completata, il destinatario riceve il messaggio di testo e la console mostra lo stato `success` dai [dati di output](twilio-notifications-connector.md#twilio-notifications-connector-data-output). A questo punto, è necessario modificare `temperature` nel messaggio di input in **29** e pubblicare. Poiché è inferiore a 30, la TempMonitor funzione non attiva un messaggio Twilio. ## Consulta anche + [Integrazione con servizi e protocolli tramite i connettori Greengrass](connectors.md) + [AWS-connettori Greengrass forniti](connectors-list.md)