Nozioni di base sui connettori Greengrass (console)

Accedere alla AWS Secrets Manager console.

Scegli Archivia un nuovo segreto.

In Scegli il tipo di segreto, scegli Altro tipo di segreto.

In Specifica le key/value coppie da archiviare per questo segreto, nella scheda Testo semplice, inserisci il tuo token di autenticazione Twilio. Rimuovi tutta la formattazione JSON e immetti solo il valore del token.

Mantieni aws/secretsmanager selezionata la chiave di crittografia, quindi scegli Avanti.

In Secret name (Nome segreto), immetti greengrass-TwilioAuthToken, quindi seleziona Next (Avanti).

Questo tutorial non richiede la rotazione, quindi scegli Disabilita la rotazione automatica, quindi scegli Avanti.

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.

Nel pannello di navigazione della AWS IoT console, in Gestisci, espandi i dispositivi Greengrass, quindi scegli Gruppi (V1).

Scegli il gruppo a cui aggiungere la risorsa segreta.

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. Puoi aggiungere, modificare e rimuovere risorse segrete da questa sezione.

Scegli Aggiungi nella sezione Segreti.

Nella pagina Aggiungi una risorsa segreta, inserisci MyTwilioAuthToken il nome della risorsa.

Per il segreto, scegli greengrass-. TwilioAuthToken

Nella sezione Seleziona etichette (opzionale), l'etichetta di staging AWSCURRENT rappresenta l'ultima versione del segreto. Questa etichetta è sempre inclusa in una risorsa segreta.

Scegliere Add resource (Aggiungi risorsa).

Nella pagina di configurazione del gruppo, scegliere Connectors (Connettori), quindi Add a connector (Aggiungi un connettore).

Nella pagina Aggiungi connettore, scegli Twilio Notifications.

Scegliere la versione .

Nella sezione Configurazione:

Scegliere Add resource (Aggiungi risorsa).

Dalla pagina di download del AWS IoT Greengrass Core SDK, scarica il AWS IoT Greengrass Core SDK for Python sul tuo computer.

Decomprimere il pacchetto scaricato per ottenere l'SDK. Il kit SDK è la cartella greengrasssdk.

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))
    }

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.

Questo è il pacchetto di distribuzione delle funzioni Lambda.

Innanzitutto, crea la funzione Lambda.

1. In Console di gestione AWS, scegli Servizi e apri la AWS Lambda console.

2. Scegli la funzione Crea, quindi scegli Autore da zero.

3. 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 è utilizzato da. AWS IoT Greengrass

4. Nella parte inferiore della pagina, scegli Crea funzione.

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 il file .zip.

   

2. Scegli Carica, quindi scegli il pacchetto di temp_monitor_python.zip distribuzione. Poi, scegli Salva.

3. Nella scheda Codice della funzione, in Impostazioni di runtime, scegli Modifica, quindi inserisci i seguenti valori.

   • In Runtime, scegliere Python 3.7.

   • In Handler (Gestore), immetti temp_monitor.function_handler

4. Selezionare Salva.

   Nota

   Il pulsante Test sulla AWS Lambda console non funziona con questa funzione. Il AWS IoT Greengrass Core SDK non contiene i moduli necessari per eseguire le funzioni Greengrass Lambda in modo indipendente nella console. AWS Lambda Questi moduli (ad esempiogreengrass_common) vengono forniti alle funzioni dopo essere stati distribuiti nel core di Greengrass.

Ora pubblica la prima versione della tua funzione Lambda e crea un alias per la versione.

1. Nel menu Actions (Operazioni), seleziona Publish new version (Pubblica nuova versione).

2. Per Version description (Descrizione versione), immettere First version, quindi scegliere Publish (Pubblica).

3. Nella pagina di configurazione TempMonitor: 1, dal menu Azioni, scegli Crea alias.

4. Nella pagina Create a new alias (Crea un nuovo alias), utilizza i seguenti valori:

   • In Nome, inserisci GG_TempMonitor.

   • In Version (Versione), selezionare 1.

   Nota

   AWS IoT Greengrass non supporta gli alias Lambda per le versioni $LATEST.

5. Scegli Crea.

Nella pagina di configurazione del gruppo, scegli la scheda Funzioni Lambda.

In Le mie funzioni Lambda, scegli Aggiungi.

Nella pagina Aggiungi funzione Lambda, scegli TempMonitor la tua funzione Lambda.

Per la versione della funzione Lambda, scegli Alias: GG_. TempMonitor

Scegli Aggiungi funzione Lambda.

Nella pagina di configurazione del gruppo, scegli la scheda Abbonamenti, quindi scegli Aggiungi abbonamento.

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.

2. Per Tipo di destinazione, scegli Connector, quindi scegli Twilio Notifications.

Per il filtro Argomento, sceglitwilio/txt.

Scegli Crea iscrizione.

Ripeti i passaggi da 1 a 4 per creare un abbonamento che AWS IoT consenta di pubblicare messaggi sulla funzione.

1. Per Tipo di sorgente, scegli Servizio, quindi scegli IoT Cloud.

2. Per Seleziona un target, scegli la funzione Lambda, quindi scegli TempMonitor.

3. In Topic filter (Filtro argomento), immettere temperature/input.

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 Connector, quindi scegli Twilio Notifications.

2. Per Tipo di destinazione, scegli Servizio, quindi scegli IoT Cloud.

3. In Topic filter (Filtro argomento), viene inserito twilio/message/status. Si tratta dell'argomento predefinito in cui pubblica il connettore.

Assicurati che il AWS IoT Greengrass core sia in esecuzione. 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.

2. Per avviare il demone:

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Nella pagina di configurazione del gruppo, scegli Deploy.

1. Nella scheda Funzioni Lambda, nella sezione Funzioni di sistema Lambda, seleziona IP detector e scegli Modifica.

2. Nella finestra di dialogo Modifica impostazioni del rilevatore IP, seleziona Rileva e sostituisci automaticamente gli endpoint del broker MQTT.

3. Selezionare 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 endpoint specificati manualmente. Ti viene chiesto il metodo di individuazione solo la prima volta che il gruppo viene distribuito.

   Nota

   Se richiesto, concedete l'autorizzazione per creare il ruolo del servizio Greengrass e associarlo al vostro Account AWS ruolo attuale. Regione AWS Questo ruolo consente di accedere AWS IoT Greengrass alle 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.

Nella home page AWS IoT della console, scegli Test.

Per Sottoscrivi all'argomento, utilizza i seguenti valori, quindi scegli Iscriviti. Il connettore Twilio Notifications pubblica informazioni sullo stato di questo argomento.

Per Pubblica su argomento, utilizza i seguenti valori, quindi scegli Pubblica per richiamare la funzione.

{
   "to_name": "recipient-name",
   "to_number": "recipient-phone-number",
   "temperature": 31
}

Se l'operazione viene completata, il destinatario riceve il messaggio di testo e la console mostra lo stato success dai dati di 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.