AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

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à.

Esegui le funzioni Lambda sul core AWS IoT Greengrass

AWS IoT Greengrassfornisce un ambiente di runtime Lambda containerizzato per il codice definito dall'utente in cui si crea. AWS Lambda Funzioni Lambda distribuite in un'esecuzione principale nel AWS IoT Greengrass runtime Lambda locale del core. Le funzioni Lambda locali possono essere attivate da eventi locali, messaggi dal cloud e altre fonti, il che offre funzionalità di elaborazione locale ai dispositivi client. Ad esempio, puoi utilizzare le funzioni Greengrass Lambda per filtrare i dati del dispositivo prima di trasmetterli al cloud.

Per distribuire una funzione Lambda su un core, si aggiunge la funzione a un gruppo Greengrass (facendo riferimento alla funzione Lambda esistente), si configurano le impostazioni specifiche del gruppo per la funzione e quindi si distribuisce il gruppo. Se la funzione accede AWS ai servizi, è inoltre necessario aggiungere le autorizzazioni necessarie al ruolo del gruppo Greengrass.

Puoi configurare parametri che determinano l'esecuzione delle funzioni Lambda, tra cui autorizzazioni, isolamento, limiti di memoria e altro. Per ulteriori informazioni, consulta Controllo dell'esecuzione delle funzioni Greengrass Lambda utilizzando la configurazione specifica del gruppo.

La tabella seguente elenca i runtime AWS Lambda supportati e le versioni del software AWS IoT Greengrass Core sul quale possono essere eseguite.

* È possibile eseguire funzioni Lambda che utilizzano questi runtime su versioni supportate diAWS IoT Greengrass, ma non è possibile crearle in. AWS Lambda Se il runtime sul tuo dispositivo è diverso dal runtime AWS Lambda specificato per quella funzione, puoi scegliere il tuo runtime utilizzando FunctionRuntimeOverride in. FunctionDefintionVersion Per ulteriori informazioni, consulta CreateFunctionDefinition. Per ulteriori informazioni sui runtime supportati, consulta la politica di supporto Runtime nella AWS LambdaDeveloper Guide.

SDK per le funzioni Greengrass Lambda

AWSfornisce tre SDK che possono essere utilizzati dalle funzioni Greengrass Lambda in esecuzione su un core. AWS IoT Greengrass Le funzioni possono utilizzare contemporaneamente questi SDK poiché sono inclusi in pacchetti differenti. Per utilizzare un SDK in una funzione Greengrass Lambda, includilo nel pacchetto di distribuzione della funzione Lambda su cui carichi. AWS Lambda

Per ulteriori informazioni sulla creazione di un pacchetto di distribuzione, consulta Creare e includere in un pacchetto una funzione Lambda il tutorial Getting Started o Creating a deployment package nella AWS LambdaDeveloper Guide.

Migrazione delle funzioni Lambda basate sul cloud

Il AWS IoT Greengrass Core SDK segue il modello di programmazione AWS SDK, che semplifica il trasferimento delle funzioni Lambda sviluppate per il cloud in funzioni Lambda eseguite su un core. AWS IoT Greengrass

Ad esempio, la seguente funzione Python Lambda utilizza AWS SDK for Python (Boto3) per pubblicare un messaggio sull'argomento some/topic nel cloud:

import boto3

iot_client = boto3.client("iot-data")
response = iot_client.publish(
    topic="some/topic", qos=0, payload="Some payload".encode()
)

Per eseguire il porting della funzione per un AWS IoT Greengrass core, nell'importistruzione e nell'clientinizializzazione, modificate il nome del boto3 modulo ingreengrasssdk, come mostrato nell'esempio seguente:

import greengrasssdk

iot_client = greengrasssdk.client("iot-data")
iot_client.publish(topic="some/topic", qos=0, payload="Some payload".encode())

La somiglianza tra i modelli di programmazione consente inoltre di sviluppare le funzioni Lambda nel cloud e quindi AWS IoT Greengrass migrarle con il minimo sforzo. Gli eseguibili Lambda non vengono eseguiti nel cloud, quindi non puoi utilizzare l'AWSSDK per svilupparli nel cloud prima della distribuzione.

Fai riferimento alle funzioni Lambda per alias o versione

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. Gli alias si trasformano in numeri di versione durante la distribuzione di gruppo. Quando si utilizzano gli alias, la versione risolta viene aggiornata alla versione a cui punta l'alias al momento della distribuzione.

AWS IoT Greengrassnon supporta gli alias Lambda per le versioni $LATEST. Le versioni $LATEST non sono legate a versioni di funzioni pubblicate e immutabili e possono essere modificate in qualsiasi momento, il che è contrario al principio dell'immutabilità della versione. AWS IoT Greengrass

Una pratica comune per mantenere aggiornate le funzioni di Greengrass Lambda con le modifiche al codice consiste nell'utilizzare un alias denominato nel gruppo Greengrass e negli PRODUCTION abbonamenti. Man mano che promuovi nuove versioni della tua funzione Lambda in produzione, indirizza l'alias all'ultima versione stabile e quindi ridistribuisci il gruppo. Puoi anche scegliere di utilizzare questo metodo per eseguire il rollback a una versione precedente.

Flussi di comunicazione per le funzioni Greengrass Lambda

Le funzioni di Greengrass Lambda supportano diversi metodi di comunicazione con altri membri del AWS IoT Greengrass gruppo, servizi locali e servizi cloud (inclusi i servizi). AWS

Comunicazione tramite messaggi MQTT

Le funzioni Lambda possono inviare e ricevere messaggi MQTT utilizzando un pattern di pubblicazione e sottoscrizione controllato dagli abbonamenti.

Questo flusso di comunicazione consente alle funzioni Lambda di scambiare messaggi con le seguenti entità:

Una sottoscrizione definisce un'origine del messaggio, una destinazione del messaggio e un argomento (o oggetto) utilizzato per instradare i messaggi dall'origine alla destinazione. I messaggi pubblicati su una funzione Lambda vengono passati al gestore registrato della funzione. Le sottoscrizioni garantiscono maggiore sicurezza e consentono interazioni prevedibili. Per ulteriori informazioni, consulta Sottoscrizioni gestite nel flusso di lavoro di messaggistica MQTT.

Altri flussi di comunicazione

Recupero dell'argomento MQTT di input (o oggetto)

AWS IoT Greengrassutilizza gli abbonamenti per controllare lo scambio di messaggi MQTT tra dispositivi client, funzioni Lambda e connettori in un gruppo e con AWS IoT o il servizio shadow locale. Le sottoscrizioni definiscono un'origine messaggio, destinazione messaggio e un argomento MQTT utilizzati per instradare i messaggi. Quando la destinazione è una funzione Lambda, il gestore della funzione viene richiamato quando l'origine pubblica un messaggio. Per ulteriori informazioni, consulta Comunicazione tramite messaggi MQTT.

L'esempio seguente mostra come una funzione Lambda può ottenere l'argomento di input da context quello passato al gestore. A tale scopo, esegue l'accesso alla chiave subject dalla gerarchia del contesto (context.client_context.custom['subject']). Nell'esempio viene inoltre analizzato il messaggio JSON di input e quindi pubblicati l'argomento e il messaggio analizzati.

import greengrasssdk
import logging

client = greengrasssdk.client('iot-data')

OUTPUT_TOPIC = 'test/topic_results'

def get_input_topic(context):
    try:
        topic = context.client_context.custom['subject']
    except Exception as e:
        logging.error('Topic could not be parsed. ' + repr(e))
    return topic
    
def get_input_message(event):
    try:
        message = event['test-key']
    except Exception as e:
        logging.error('Message could not be parsed. ' + repr(e))
    return message

def function_handler(event, context):
    try:
        input_topic = get_input_topic(context)
        input_message = get_input_message(event)
        response = 'Invoked on topic "%s" with message "%s"' % (input_topic, input_message)
        logging.info(response)
    except Exception as e:
        logging.error(e)

    client.publish(topic=OUTPUT_TOPIC, payload=response)

    return

Per testare la funzione, aggiungerlo al gruppo utilizzando le impostazioni di configurazione predefinite. Quindi, aggiungere le seguenti sottoscrizioni e distribuire il gruppo. Per istruzioni, consulta Modulo 3 (Parte 1): Lambda suAWS IoT Greengrass.

Al termine della distribuzione, invoca la funzione.

Configurazione del ciclo di vita per le funzioni Greengrass Lambda

Il ciclo di vita della funzione Greengrass Lambda determina quando una funzione viene avviata e come crea e utilizza i contenitori. Inoltre, il ciclo di vita determina il modo in cui vengono conservate le variabili e la logica di preelaborazione che sono al di fuori dell'handler della funzione.

AWS IoT Greengrass supporta i cicli di vita on demand (impostazione predefinita) o di lunga durata:

Per ulteriori informazioni sul riutilizzo dei contenitori, consulta Understanding Container Reuse nel blog di Compute. AWS Lambda AWS

Eseguibili Lambda

Questa funzionalità è disponibile per AWS IoT Greengrass Core v1.6 e versioni successive.

Un eseguibile Lambda è un tipo di funzione Greengrass Lambda che è possibile utilizzare per eseguire codice binario nell'ambiente principale. Consente di eseguire funzionalità specifiche del dispositivo in modo nativo e di sfruttare l'ingombro ridotto del codice compilato. Gli eseguibili Lambda possono essere richiamati da eventi, richiamare altre funzioni e accedere a risorse locali.

Gli eseguibili Lambda supportano solo il tipo di codifica binaria (non JSON), ma per il resto puoi gestirli nel tuo gruppo Greengrass e distribuirli come le altre funzioni di Greengrass Lambda. Tuttavia, il processo di creazione degli eseguibili Lambda è diverso dalla creazione delle funzioni Lambda Python, Java e Node.js:

Gli eseguibili Lambda devono implementare determinate chiamate e modelli di programmazione nel codice della funzione. Ad esempio, il metodo main deve effettuare le seguenti operazioni:

Il frammento seguente è il main metodo tratto dall'esempio di codice simple_handler.c in poi. GitHub

int main() {
    gg_error err = GGE_SUCCESS;

    err = gg_global_init(0);
    if(err) {
        gg_log(GG_LOG_ERROR, "gg_global_init failed %d", err);
        goto cleanup;
    }

    gg_runtime_start(handler, 0);

cleanup:
    return -1;
}

Per ulteriori informazioni su requisiti, vincoli e altri dettagli di implementazione, consulta Core SDK for C. AWS IoT Greengrass

Creare un file eseguibile Lambda

Dopo aver compilato il codice insieme all'SDK, usa l'AWS LambdaAPI per creare una funzione Lambda e caricare l'eseguibile compilato.

L'esempio seguente utilizza il comando CLI create-function per creare un eseguibile Lambda. Il comando specifica:

aws lambda create-function \
--region aws-region \
--function-name function-name \
--handler executable-name \
--role role-arn \
--zip-file fileb://file-name.zip \
--runtime arn:aws:greengrass:::runtime/function/executable

A questo punto, utilizza l'API AWS Lambda per pubblicare una versione e creare un alias.

Quindi, aggiungi l'eseguibile Lambda a un gruppo Greengrass, configuralo per accettare dati di input binari nelle impostazioni specifiche del gruppo e distribuisci il gruppo. È possibile farlo nella console AWS IoT Greengrass o utilizzando l'API AWS IoT Greengrass.