Nozioni di base sui connettori Greengrass (console)

Accedere alla console AWS Secrets Manager.

Scegli Archivia un nuovo segreto.

UNDERScegli il tipo segreto, scegliOther type of secret (Altro tipo di segreto).

In Specify the key/value pairs to be stored for this secret (Specifica le coppie chiave/valore da archiviare per il segreto), nella scheda Plaintext (Testo normale), immettere il token di autorizzazione Twilio. Rimuovi tutta la formattazione JSON e immetti solo il valore del token.

Keepaws/secretsmanagerselezionato per la chiave di crittografia, quindi scegliSuccessivo.

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

Questo tutorial non richiede la rotazione. Scegliere quindi Disable automatic rotation (Disabilita rotazione automatica), quindiSuccessivo.

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.

NellaAWS IoTRiquadro di navigazione della console, nellaManage (Gestione), espandiDispositivi Greengrasse quindi scegliereGruppi (V1).

Scegli il gruppo a cui aggiungere la risorsa segreta.

Nella pagina di configurazione del gruppo, scegli l'Risorsequindi scorri verso il basso fino allaSegretiSezione. LaSegretimostra le risorse segrete appartenenti al gruppo. Puoi aggiungere, modificare e rimuovere le risorse segrete da questa sezione.

ScegliereInserisciinSegretiSezione.

SulAggiunta di una risorsa segretapagina, inserisciMyTwilioAuthTokenperNome risorsa.

Per ilSecret, scegligreengrass -TwilioAuthToken.

NellaSeleziona etichette (opzionale)Sezione, la AWSCURRENT L'etichetta di gestione temporanea rappresenta la versione più recente 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).

SulAggiungi connettorepagina, scegliereNotifiche Twilio.

Scegliere la versione .

NellaConfigurazioneSezione:

Scegliere Add resource (Aggiungi risorsa).

DaAWS IoT GreengrassCore SDKpagina di download, scarica ilAWS IoT GreengrassCore SDK per 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 file è il pacchetto di distribuzione della funzione Lambda.

Innanzitutto, crea la funzione Lambda.

1. Nella AWS Management Console, scegli Services (Servizi) e apri la console AWS Lambda.

2. ScegliereCrea funzionequindi scegliereAuthor from scratch (Crea 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.

   • PerAutorizzazioni, mantenere l'impostazione predefinita. Questo crea un ruolo di esecuzione che concede le autorizzazioni Lambda di base. Questo ruolo non viene utilizzato daAWS IoT Greengrass.

4. Nella parte inferiore della pagina scegliCrea funzione.

Quindi, registra il gestore e carica il pacchetto di distribuzione della funzione Lambda.

1. SulCodescheda, sottoCodice sorgente, scegliCarica da. Dal menu a discesa, sceglifile in formato zip.

   

2. ScegliereCaricamentoquindi scegli iltemp_monitor_python.zippacchetto di distribuzione. Quindi, scegliere Save (Salva).

3. SulCodetab per la funzione, sottoImpostazioni di runtime, scegliModificare, quindi impostare i seguenti valori.

   • In Runtime, scegliere Python 3.7.

   • In Handler (Gestore), immetti temp_monitor.function_handler

4. Seleziona Save (Salva.

   Nota

   LaTestpulsante sullaAWS Lambdanon funziona con questa funzione. LaAWS IoT GreengrassCore SDK non contiene moduli necessari per eseguire le funzioni Lambda di Greengrass in modo indipendente nelAWS Lambdaconsole. Questi moduli (ad esempio,greengrass_common) vengono forniti alle funzioni dopo che sono state implementate nel core Greengrass.

Ora, pubblica la prima versione della funzione Lambda e crea unalias 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. SulTempMonitor: 1pagina di configurazione, dallaOperazionimenu, scegliCreare alias.

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

   • In Name (Nome), inserire GG_TempMonitor.

   • In Version (Versione), selezionare 1.

   Nota

   AWS IoT Greengrassnon supporta gli alias Lambda per$LATESTVersioni.

5. Scegli Crea.

Nella pagina di configurazione del gruppo, scegli l'Funzioni Lambdalinguetta.

UNDERFunzioni Lambda, scegliInserisci.

SulAggiungi funzione Lambdapagina, scegliereTempMonitorper la funzione Lambda.

PerVersione delle funzioni Lambda, scegliAlias: GG_TempMonitor.

ScegliereAggiungi funzione Lambda.

Nella pagina di configurazione del gruppo, scegli l'Abbonamentischeda, quindi scegliAggiungi sottoscrizione.

SulCreazione di una sottoscrizione, configura l'origine e la destinazione come indicato di seguito:

1. PerTipo di origine, scegliLambda function (Funzione Lambda)e quindi scegliereTempMonitor.

2. PerTarget type (Tipo di destinazione), scegliConnectore quindi scegliereNotifiche Twilio.

Per ilFiltro di argomenti, sceglitwilio/txt.

Scegliere Create Subscription (Crea iscrizione).

Ripetere le fasi da 1 a 4 per creare un abbonamento che consente a AWS IoT di pubblicare messaggi nella funzione.

1. PerTipo di origine, scegliService (Servizio)e quindi scegliereIoT Cloud.

2. PerSeleziona un target, scegliLambda function (Funzione Lambda)e quindi scegliereTempMonitor.

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. PerTipo di origine, scegliConnectore quindi scegliereNotifiche Twilio.

2. PerTarget type (Tipo di destinazione), scegliService (Servizio)e quindi scegliereIoT Cloud.

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

Assicurarsi che il fileAWS IoT Greengrasscore è 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 nel percorso dipende dalla versione del software AWS IoT Greengrass Core installata sul dispositivo core.

2. Per avviare il daemon:

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

Nella pagina di configurazione del gruppo, scegliDistribuzione.

1. NellaFunzioni Lambdascheda, sotto la schedaFunzioni Lambda del sistemasezione, selezionaRilevatore di IPe scegliModificare.

2. NellaModifica impostazioni rilevatore IPfinestra di dialogo, selezionareRileva e sostituisci automaticamente gli endpoint del broker MQTT.

3. Seleziona Save (Salva.

   Questo consente ai dispositivi di acquisire automaticamente informazioni di base sulla connettività, come, ad esempio indirizzo IP, DNS e numero della porta. È consigliato il rilevamento automatico, ma AWS IoT Greengrass supporta anche endpoint specifici manualmente. Ti viene chiesto il metodo di individuazione solo la prima volta che il gruppo viene distribuito.

   Nota

   Se richiesto, concedi l'autorizzazione per creare ilRuolo del servizio Greengrasse associalo al tuoAccount AWSnella correnteRegione AWS. Tale ruolo consente aAWS IoT Greengrassper accedere alle risorse inAWSServizi .

   Nella pagina Deployments (Distribuzioni) vengono visualizzati il timestamp della distribuzione, l'ID versione e lo stato. Una volta completata, la distribuzione dovrebbe mostrare lo statoCompletato.

   Per la risoluzione dei problemi, consultare Risoluzione dei problemi relativi a AWS IoT Greengrass.

SulAWS IoTHome page della console, scegliTest.

PerSottoscrizione all'argomento, utilizza i seguenti valori, quindi scegliSottoscrizione. I connettori Twilio Notifications pubblicano informazioni sullo stato in questo argomento.

PerPubblicazione nell'argomento, utilizza i seguenti valori, quindi scegliPubblicareper 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é è un valore inferiore a 30, il TempMonitor non attiverà un messaggio Twilio.