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

Utilizzo dei livelli per le funzioni Lambda Node.js

Un livello Lambda è un archivio di file .zip che può contenere codice o dati aggiuntivi. I livelli di solito contengono dipendenze dalla libreria, un runtime personalizzato o file di configurazione. La creazione di un livello prevede tre passaggi generali:

Questo argomento contiene passaggi e indicazioni su come creare un pacchetto e un livello Lambda per Node.js con dipendenze di librerie esterne.

Prerequisiti

Per completare le fasi riportate in questa sezione, è necessario:

In questo argomento, facciamo riferimento all'applicazione di esempio layer-nodejs nel repository GitHub aws-lambda-developer-guide. Questa applicazione contiene script che scaricano una dipendenza e la impacchettano in un livello. L'applicazione contiene anche le funzioni corrispondenti che utilizzano la dipendenza dal livello. Dopo aver creato un livello, puoi implementare e richiamare la funzione corrispondente per verificare che tutto funzioni. Questa applicazione di esempio utilizza il runtime Node.js 20. Se si aggiungono altre dipendenze al livello, queste dovranno essere compatibili con Node.js 20.

L'applicazione layer-nodejs di esempio impacchetterà la libreria lodash in un livello Lambda. La directory layer contiene gli script per generare il livello. La directory function contiene una funzione di esempio per verificare il funzionamento del livello. Questo documento spiega come creare, impacchettare, implementare e testare questo livello.

Compatibilità dei livelli Node.js con l'ambiente di runtime Lambda

Quando si impacchetta il codice in un livello Node.js, si specificano gli ambienti di runtime Lambda con cui il codice è compatibile. Per valutare la compatibilità del codice con un runtime, considerate le versioni di Node.js, i sistemi operativi e le architetture di set di istruzioni per cui è progettato il codice.

I runtime Lambda Node.js specificano la versione Node.js e il sistema operativo. In questo documento, utilizzerai il runtime Node.js 20, basato su AL2023. Per ulteriori informazioni sulle versioni di runtime, consulta Runtime supportati. Quando crei una funzione Lambda, puoi specificare l'architettura del set di istruzioni. In questo documento, utilizzerai l'architettura arm64. Per ulteriori informazioni sulle architetture in Lambda, consulta Selezione e configurazione di un'architettura di set di istruzioni per la funzione Lambda.

Quando si utilizza il codice fornito in un pacchetto, ogni manutentore del pacchetto definisce in modo indipendente la propria compatibilità. La maggior parte dello sviluppo di Node.js è progettato per funzionare indipendentemente dal sistema operativo e dall'architettura del set di istruzioni. Inoltre, l'interruzione delle incompatibilità con le nuove versioni di Node.js non è così comune. Aspettati di dedicare più tempo alla valutazione della compatibilità tra i pacchetti che alla valutazione della compatibilità dei pacchetti con la versione di Node.js, il sistema operativo o l'architettura del set di istruzioni.

A volte i pacchetti Node.js includono codice compilato, che richiede di considerare la compatibilità del sistema operativo e dell'architettura del set di istruzioni. Se è necessario valutare la compatibilità del codice per i pacchetti, sarà necessario esaminare i pacchetti e la relativa documentazione. I pacchetti in NPM possono specificare la loro compatibilità tramite i campi engines, os e cpu del loro file manifesto package.json. Per ulteriori informazioni sui file package.json, consulta package.json nella documentazione di NPM.

Percorsi dei livelli per i runtime Node.js

Quando si aggiunge un livello a una funzione, Lambda carica il contenuto del livello nell'ambiente di esecuzione. Se il livello impacchetta le dipendenze in percorsi di cartelle specifici, l'ambiente di esecuzione Node.js riconoscerà i moduli e sarà possibile fare riferimento ai moduli dal codice della funzione.

Per garantire che i moduli vengano raccolti, impacchettali nel file layer.zip in uno dei seguenti percorsi di cartella. Questi file vengono archiviati in /opt e i percorsi delle cartelle vengono caricati nella variabile di ambiente PATH.

Ad esempio, il file .zip del livello risultante creato in questo tutorial ha la seguente struttura di directory:

layer_content.zip
└ nodejs
    └ node20
        └ node_modules
            └ lodash
            └ <other potential dependencies>
            └ ...

Inserisci la libreria lodash nella cartella nodejs/node20/node_modules. Ciò garantisce che Lambda possa localizzare la libreria durante l'invocazione delle funzioni.

Impacchettamento del contenuto dei livelli

In questo esempio, impacchetti la libreria lodash in un file .zip di livelli. Per installare e creare il pacchetto del contenuto del livello, completa i seguenti passaggi.

Creazione del livello

Prendi il file layer_content.zip che hai generato nella sezione precedente e caricalo come livello Lambda. È possibile caricare un livello utilizzando la AWS Management Console o l'API Lambda tramite la AWS Command Line Interface (AWS CLI). Quando carichi il file .zip dei livelli, nel seguente comando AWS CLIPublishLayerVersion, specifica nodejs20.x come runtime compatibile e arm64 come architettura compatibile.

aws lambda publish-layer-version --layer-name nodejs-lodash-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes nodejs20.x \
    --compatible-architectures "arm64"

Dalla risposta, nota LayerVersionArn, che assomiglia a arn:aws:lambda:us-east-1:123456789012:layer:nodejs-lodash-layer:1. Avrai bisogno di questo nome della risorsa Amazon (ARN) nel passaggio successivo di questo tutorial, quando aggiungerai il livello alla tua funzione.

Aggiunta del livello alla tua funzione

Implementa una funzione Lambda di esempio che utilizza la libreria lodash nel suo codice funzione, quindi collega il livello che hai creato. Per implementare la funzione, è necessario un ruolo di esecuzione. Per ulteriori informazioni, consulta Definizione delle autorizzazioni della funzione Lambda con un ruolo di esecuzione. Se non disponi ancora di un ruolo di esecuzione, completa i passaggi nella sezione comprimibile. Altrimenti, passa alla sezione successiva per implementare la funzione.

Il codice della funzione di esempio utilizza il metodo _.findLastIndex lodash per leggere una serie di oggetti. Confronta gli oggetti con un criterio per trovare l'indice di una corrispondenza. Quindi, restituisce l'indice e il valore dell'oggetto nella risposta Lambda.

import _ from "lodash"

export const handler = async (event) => {

  var users = [
  { 'user': 'Carlos',  'active': true },
  { 'user': 'Gil-dong',    'active': false },
  { 'user': 'Pat', 'active': false }
  ];

  let out = _.findLastIndex(users, function(o) { return o.user == 'Pat'; });
  const response = {
    statusCode: 200,
    body: JSON.stringify(out + ", " + users[out].user),
  };
  return response;
};