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

Lavorare con i livelli per le funzioni Python Lambda

Un layer Lambda è un archivio di file.zip che contiene codice o dati supplementari. 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 layer Python Lambda con dipendenze di librerie esterne.

Prerequisiti

Per seguire i passaggi di questa sezione, è necessario disporre di quanto segue:

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 le dipendenze dai livelli. Dopo aver creato un livello, potete 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 layer-python esempio, ci sono due esempi:

Compatibilità a livello 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 sono disponibili come ruote (.whlfile) 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 layer 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 disponibile). La ruota universale contiene any un tag della piattaforma, che indica che è compatibile con tutte le piattaforme, incluso Amazon Linux.

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

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

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 Docker basato sull'immagine del contenitore 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 di livello per i runtime di 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 la PATH variabile raccolga il contenuto del layer, il file layer.zip dovrebbe avere le sue dipendenze nei seguenti percorsi di cartella:

Ad esempio, il file.zip del layer 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 requestslibreria è posizionata correttamente nella python/lib/python3.11/site-packages directory. Ciò garantisce che Lambda possa localizzare la libreria durante le chiamate delle funzioni.

Imballaggio del contenuto del livello

In questo esempio, impacchettate la requests libreria Python in un file.zip di livello. Completate i seguenti passaggi per installare e impacchettare il contenuto del layer.

Creazione del livello

In questa sezione, prendi il layer_content.zip file che hai generato nella sezione precedente e lo carichi come layer Lambda. È possibile caricare un layer utilizzando AWS Management Console o Lambda API 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 ilLayerVersionArn, che arn:aws:lambda:us-east-1:123456789012:layer:python-requests-layer:1 assomiglia a. Avrai bisogno di questo Amazon Resource Name (ARN) nel passaggio successivo di questo tutorial, quando aggiungi il layer alla tua funzione.

Aggiungere il layer alla tua funzione

In questa sezione, si distribuisce una funzione Lambda di esempio che utilizza requests la libreria nel relativo codice funzione, quindi si collega il layer. Per distribuire la funzione, è necessario un. Definizione delle autorizzazioni della funzione Lambda con un ruolo di esecuzione Se non disponi di un ruolo di esecuzione esistente, segui i passaggi nella sezione comprimibile.

Il codice della funzione Lambda importa la requests libreria, effettua una semplice HTTP richiesta 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 manylinux delle ruote

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 manylinux invece la ruota che supporta. 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 numpy pacchetto nel layer, è possibile completare i seguenti passaggi di esempio per installare e impacchettare correttamente il layer.

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 ilLayerVersionArn, che arn:aws:lambda:us-east-1:123456789012:layer:python-numpy-layer:1 assomiglia a. Per verificare che il layer funzioni come previsto, distribuite la funzione Lambda nella function-numpy directory.