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 in Python

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 impacchettare e creare correttamente un livello Lambda per Python con dipendenze di librerie esterne.

Prerequisiti

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

In questo argomento, facciamo riferimento all'applicazione di layer-pythonesempio nel repository awsdocs GitHub . Questa applicazione contiene script che scaricano le dipendenze e generano i livelli. L'applicazione contiene anche le funzioni corrispondenti che utilizzano la dipendenza dai livelli. Dopo aver creato un livello, puoi implementare e richiamare la funzione corrispondente per verificare che tutto funzioni correttamente. Poiché si utilizza il runtime Python 3.11 per le funzioni, i livelli devono essere compatibili anche con Python 3.11.

Nell'applicazione di esempio layer-python, ci sono due esempi:

Compatibilità dei livelli Python con Amazon Linux

Il primo passaggio per creare un livello consiste nel raggruppare tutto il contenuto del livello in un archivio di file .zip. Perché le funzioni Lambda vengano eseguite su Amazon Linux, il contenuto del livello deve essere in grado di compilare e creare in un ambiente Linux.

In Python, la maggior parte dei pacchetti è disponibile come ruote (file .whl) oltre alla distribuzione dei sorgenti. Ogni ruota è un tipo di distribuzione integrata che supporta una combinazione specifica di versioni di Python, sistemi operativi e set di istruzioni della macchina.

Le ruote sono utili per garantire che il tuo livello sia compatibile con Amazon Linux. Quando scarichi le tue dipendenze, scarica la ruota universale, se possibile. (Per impostazione predefinita, pip installa la ruota universale, se ne è disponibile una). La ruota universale contiene any un tag della piattaforma, che indica che è compatibile con tutte le piattaforme, incluso Amazon Linux.

Nell'esempio che segue, la libreria requests viene impacchettata in un livello Lambda. La libreria requests è un esempio di pacchetto disponibile come ruota universale.

Non tutti i pacchetti Python sono distribuiti come ruote universali. Ad esempio, numpy ha più distribuzioni di ruote, ognuna delle quali supporta un diverso set di piattaforme. Per tali pacchetti, scarica la distribuzione manylinux per garantire la compatibilità con Amazon Linux. Per le istruzioni dettagliate su come impacchettare tali livelli, consulta Utilizzo delle distribuzioni di ruote manylinux.

In rari casi, un pacchetto Python potrebbe non essere disponibile come ruota. Se esiste solo la distribuzione del codice sorgente (sdist), ti consigliamo di installare e impacchettare le dipendenze in un ambiente basato su Docker sull'immagine di container di base di Amazon Linux 2023. Consigliamo questo approccio anche se desideri includere le tue librerie personalizzate scritte in altri linguaggi come C/C++. Questo approccio imita l'ambiente di esecuzione Lambda in Docker e garantisce che le dipendenze dei pacchetti non Python siano compatibili con Amazon Linux.

Percorsi dei livelli per i runtime Python

Quando si aggiunge un livello a una funzione, Lambda carica il contenuto del livello nella directory /opt di quell'ambiente di esecuzione. Per ogni runtime Lambda, la variabile PATH include percorsi di cartelle specifici nella directory /opt. Per garantire che Lambda raccolga il contenuto del layer, il file.zip del layer deve avere le sue dipendenze nei seguenti percorsi di cartella:

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

layer_content.zip
└ python
    └ lib
        └ python3.11
            └ site-packages
                └ requests
                └ <other_dependencies> (i.e. dependencies of the requests package)
                └ ...

La libreria requests è posizionata correttamente nella directory python/lib/python3.11/site-packages. Ciò garantisce che Lambda possa localizzare la libreria durante l'invocazione delle funzioni.

Impacchettamento del contenuto dei livelli

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

Creazione del livello

In questa sezione, viene utilizzato il file layer_content.zip generato nella sezione precedente e viene caricato come livello Lambda. È possibile caricare un layer utilizzando AWS Management Console o l'API Lambda tramite AWS Command Line Interface ()AWS CLI. Quando caricate il file Layer .zip, nel PublishLayerVersion AWS CLI comando seguente, specificate python3.11 come runtime compatibile e arm64 come architettura compatibile.

aws lambda publish-layer-version --layer-name python-requests-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes python3.11 \
    --compatible-architectures "arm64"

Dalla risposta, nota LayerVersionArn, che assomiglia a arn:aws:lambda:us-east-1:123456789012:layer:python-requests-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

In questa sezione, viene implementata una funzione Lambda di esempio che utilizza la libreria requests nel suo codice funzione, quindi si collega il livello. Per implementare la funzione, è necessario un ruolo di esecuzione. Se non disponi ancora di un ruolo di esecuzione, completa i passaggi nella sezione comprimibile.

Il codice della funzione Lambda importa la libreria requests, effettua una semplice richiesta HTTP e quindi restituisce il codice di stato e il corpo.

import requests

def lambda_handler(event, context):
    print(f"Version of requests library: {requests.__version__}")
    request = requests.get('https://api.github.com/')
    return {
        'statusCode': request.status_code,
        'body': request.text
    }

Utilizzo delle distribuzioni di ruote manylinux

A volte, un pacchetto che si desidera includere come dipendenza non ha una ruota universale (in particolare, non ha any come tag della piattaforma). In questo caso, scarica la ruota che invece supporta manylinux. Ciò garantisce che le tue librerie di livelli siano compatibili con Amazon Linux.

numpy è un pacchetto che non dispone di una ruota universale. Se si desidera includere il pacchetto numpy nel livello, è possibile completare i seguenti passaggi di esempio per installare e impacchettare correttamente il livello.

Per caricare questo layer su Lambda, usa il seguente comando: PublishLayerVersion AWS CLI

aws lambda publish-layer-version --layer-name python-numpy-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes python3.11 \
    --compatible-architectures "x86_64"

Dalla risposta, nota LayerVersionArn, che assomiglia a arn:aws:lambda:us-east-1:123456789012:layer:python-numpy-layer:1. Per verificare che il livello funzioni come previsto, implementa la funzione Lambda nella directory function-numpy.