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 di archivi di file .zip per le funzioni Lambda in Python

Il codice della AWS Lambda funzione comprende un file.py contenente il codice del gestore della funzione, insieme a tutti i pacchetti e i moduli aggiuntivi da cui dipende il codice. Per implementare questo codice della funzione in Lambda, utilizza un pacchetto di implementazione. Questo pacchetto può essere un archivio di file .zip o un'immagine di container. Per ulteriori informazioni sull'uso delle immagini di container con Python, consulta la sezione Implementazione di funzioni Lambda in Python con immagini di container.

Per creare un pacchetto di implementazione come archivio di file .zip, puoi utilizzare l'utilità di archiviazione di file .zip incorporata del tuo strumento della linea di comando o qualsiasi altra utilità file .zip, come ad esempio 7zip. Gli esempi mostrati nelle sezioni seguenti presuppongono che tu stia utilizzando uno strumento della linea di comando zip in un ambiente Linux o MacOS. Per utilizzare gli stessi comandi in Windows, puoi installare il sottosistema Windows per Linux per ottenere una versione di Ubuntu e Bash integrata con Windows.

Tieni presente che Lambda utilizza le autorizzazioni relative ai POSIX file, quindi potrebbe essere necessario impostare le autorizzazioni per la cartella del pacchetto di distribuzione prima di creare l'archivio del file.zip.

Dipendenze di runtime in Python

Per le funzioni Lambda che utilizzano il runtime Python, una dipendenza può essere qualsiasi pacchetto o modulo Python. Quando si distribuisce la funzione utilizzando un archivio.zip, è possibile aggiungere queste dipendenze al file.zip con il codice della funzione o utilizzare un layer Lambda. Un livello è un file .zip separato che può contenere codice aggiuntivo o altri contenuti. Per saperne di più sull'utilizzo dei layer Lambda in Python, consulta. Lavorare con i livelli per le funzioni Python Lambda

I runtime Lambda Python includono e le relative dipendenze. AWS SDK for Python (Boto3) Lambda fornisce SDK in fase di esecuzione gli scenari di distribuzione in cui non è possibile aggiungere dipendenze personalizzate. Questi scenari includono la creazione di funzioni nella console utilizzando l'editor di codice integrato o l'utilizzo di funzioni in linea in AWS Serverless Application Model (AWS SAM) o modelli. AWS CloudFormation

Lambda aggiorna periodicamente le librerie nel runtime Python per includere gli aggiornamenti e le patch di sicurezza più recenti. Se la funzione utilizza la versione di Boto3 SDK inclusa nel runtime ma il pacchetto di distribuzione include SDK dipendenze, ciò può causare problemi di disallineamento della versione. Ad esempio, il pacchetto di distribuzione potrebbe includere la dipendenza urllib3. SDK Quando Lambda aggiorna il file SDK in fase di esecuzione, i problemi di compatibilità tra la nuova versione del runtime e la versione di urllib3 nel pacchetto di distribuzione possono causare il fallimento della funzione.

Per scoprire quale versione di SDK for Python (Boto3) è inclusa nel runtime che stai utilizzando, vedi. Versioni incluse in runtime SDK

In base al modello di responsabilità condivisa di AWS, è tua responsabilità gestire eventuali dipendenze nei pacchetti di implementazione delle tue funzioni. Ciò include l'applicazione di aggiornamenti e patch di sicurezza. Per aggiornare le dipendenze nel pacchetto di implementazione della funzione, crea prima un nuovo file .zip e poi caricalo su Lambda. Per ulteriori informazioni, consulta Creazione di un pacchetto di implementazione .zip con dipendenze e Creazione e aggiornamento delle funzioni Lambda di Python utilizzando file .zip.

Creazione di un pacchetto di implementazione .zip senza dipendenze

Se il codice della funzione non ha dipendenze, il file .zip contiene solo il file .py con il codice del gestore della funzione. Usa la tua utilità zip preferita per creare un file .zip con il file .py nella directory principale. Se il file .py non si trova nella directory principale del file .zip, Lambda non sarà in grado di eseguire il codice.

Per informazioni su come implementare il file .zip per creare una nuova funzione Lambda o aggiornarne una esistente, consulta la sezione Creazione e aggiornamento delle funzioni Lambda di Python utilizzando file .zip.

Creazione di un pacchetto di implementazione .zip con dipendenze

Se il codice della funzione dipende da pacchetti o moduli aggiuntivi, puoi aggiungere queste dipendenze al tuo file.zip con il codice della funzione o utilizzare un livello Lambda. Le istruzioni in questa sezione mostrano come includere le dipendenze nel pacchetto di implementazione .zip. Affinché Lambda esegua il codice, il file .py contenente il codice del gestore e tutte le dipendenze della funzione deve essere installato nella radice del file .zip.

Supponiamo che il codice della funzione sia salvato in un file denominato lambda_function.py. I seguenti CLI comandi di esempio creano un file.zip denominato my_deployment_package.zip contenente il codice della funzione e le relative dipendenze. Puoi installare le tue dipendenze direttamente in una cartella nella directory del tuo progetto o utilizzare un ambiente virtuale Python.

Percorso di ricerca delle dipendenze e librerie incluse nel runtime

Quando utilizzi un'istruzione import nel codice, il runtime Python cerca nelle directory del suo percorso di ricerca finché non trova il modulo o il pacchetto. Per impostazione predefinita, la prima posizione cercata dal runtime è la directory in cui il pacchetto di implementazione .zip viene decompresso e montato (/var/task). Se includi una versione di una libreria inclusa nel runtime nel tuo pacchetto di implementazione, questa versione avrà la precedenza sulla versione inclusa nel runtime. Le dipendenze nel pacchetto di implementazione hanno la precedenza anche sulle dipendenze nei livelli.

Quando aggiungi una dipendenza a un livello, Lambda la estrae in /opt/python/lib/python3.x/site-packages, dove python3.x  rappresenta la versione del runtime che stai utilizzando, o /opt/python. Nel percorso di ricerca, queste directory hanno la precedenza sulle directory contenenti le librerie incluse nel runtime e le librerie installate con pip (/var/runtime e /var/lang/lib/python3.x/site-packages). Le librerie nei livelli di funzione hanno quindi la precedenza sulle versioni incluse nel runtime.

Puoi visualizzare il percorso di ricerca completo per la tua funzione Lambda aggiungendo il seguente frammento di codice.

import sys
      
search_path = sys.path
print(search_path)

Puoi anche aggiungere dipendenze in una cartella separata all'interno del tuo pacchetto .zip. Ad esempio, potreste aggiungere una versione di Boto3 a una cartella del pacchetto .zip denominata. SDK common Quando il pacchetto .zip viene decompresso e montato, questa cartella viene inserita nella directory /var/task. Per utilizzare nel codice una dipendenza da una cartella del pacchetto di implementazione .zip, utilizza un'istruzione import from. Ad esempio, per utilizzare una versione di Boto3 da una cartella denominata common nel tuo pacchetto .zip, usa la seguente istruzione.

from common import boto3

Utilizzo delle cartelle __pycache__

È consigliabile non includere cartelle __pycache__ nel pacchetto di implementazione della funzione. Il bytecode Python compilato su un computer di compilazione con un'architettura o un sistema operativo diverso potrebbe non essere compatibile con l'ambiente di esecuzione Lambda.

Creazione di un pacchetto di implementazione .zip con librerie native

Se la tua funzione utilizza solo pacchetti e moduli Python puri, puoi usare il comando pip install per installare le tue dipendenze su qualsiasi computer di compilazione locale e creare il file .zip. Molte librerie Python popolari, tra cui NumPy e Pandas, non sono Python puro e contengono codice scritto in C o C++. Quando aggiungi librerie contenenti codice C/C++ al pacchetto di implementazione, devi creare il pacchetto correttamente per assicurarti che sia compatibile con l'ambiente di esecuzione Lambda.

La maggior parte dei pacchetti disponibili nel Python Package Index (PyPI) sono disponibili come "wheel" (file .whl). Un file.whl è un tipo di ZIP file che contiene una distribuzione integrata con binari precompilati per un particolare sistema operativo e un'architettura di set di istruzioni. Per rendere il pacchetto di implementazione compatibile con Lambda, è necessario installare il wheel per i sistemi operativi Linux e l'architettura del set di istruzioni della funzione.

Alcuni pacchetti possono essere disponibili solo come distribuzioni di origine. Per questi pacchetti, è necessario compilare e creare personalmente i componenti C/C++.

Per vedere quali distribuzioni sono disponibili per il pacchetto richiesto, procedi come segue:

Utilizzo di distribuzioni integrate (wheel)

Per scaricare un wheel compatibile con Lambda, utilizza l'opzione --platform in pip.

Se la tua funzione Lambda utilizza l'architettura del set di istruzioni x86_64, esegui il comando pip install seguente per installare un wheel compatibile nella tua directory package. Sostituisci --python 3.x con la versione del runtime Python che stai utilizzando.

pip install \
--platform manylinux2014_x86_64 \
--target=package \
--implementation cp \
--python-version 3.x \
--only-binary=:all: --upgrade \
<package_name>

Se la funzione utilizza l'architettura del set di istruzioni arm64, esegui il seguente comando. Sostituisci --python 3.x con la versione del runtime Python che stai utilizzando.

pip install \
--platform manylinux2014_aarch64 \
--target=package \
--implementation cp \
--python-version 3.x \
--only-binary=:all: --upgrade \
<package_name>

Utilizzo delle distribuzioni di origine

Se il tuo pacchetto è disponibile solo come distribuzione di origine, la creazione delle librerie C/C++ spetta a te. Per rendere il pacchetto compatibile con l'ambiente di esecuzione Lambda, devi crearlo in un ambiente che utilizza lo stesso sistema operativo Amazon Linux 2. Puoi farlo creando il tuo pacchetto in un'istanza Amazon EC2 Linux.

Per informazioni su come avviare e connettersi a un'istanza Amazon EC2 Linux, consulta il Tutorial: Guida introduttiva alle istanze Amazon EC2 Linux nella Amazon EC2 User Guide for Linux Instances.

Creazione e aggiornamento delle funzioni Lambda di Python utilizzando file .zip

Dopo aver creato il pacchetto di distribuzione.zip, puoi utilizzarlo per creare una nuova funzione Lambda o aggiornarne una esistente. Puoi distribuire il tuo pacchetto.zip utilizzando la console Lambda, il AWS Command Line Interface e Lambda. API Puoi anche creare e aggiornare le funzioni Lambda usando AWS Serverless Application Model (AWS SAM) e AWS CloudFormation.

La dimensione massima per un pacchetto di implementazione .zip per Lambda è di 250 MB (dopo l'estrazione). Nota che questo limite si applica alla dimensione combinata di tutti i file caricati, inclusi eventuali livelli Lambda.

Il runtime Lambda necessita dell'autorizzazione per leggere i file nel pacchetto di distribuzione. Nella notazione ottale delle autorizzazioni Linux, Lambda richiede 644 permessi per i file non eseguibili (rw-r--r--) e 755 permessi () per le directory e i file eseguibili. rwxr-xr-x

In Linux e macOS, utilizza il comando chmod per modificare le autorizzazioni file su file e directory nel pacchetto di implementazione. Ad esempio, per assegnare a un file eseguibile le autorizzazioni corrette, utilizza il comando seguente.

chmod 755 <filepath>

Per modificare le autorizzazioni file in Windows, consulta Set, View, Change, or Remove Permissions on an Object nella documentazione di Microsoft Windows.

Creazione e aggiornamento delle funzioni con file .zip utilizzando la console

Per creare una nuova funzione, devi prima creare la funzione nella console, quindi devi caricare il tuo archivio .zip. Per aggiornare una funzione esistente, apri la pagina relativa alla funzione, quindi segui la stessa procedura per aggiungere il file .zip aggiornato.

Se il file .zip ha dimensioni inferiori a 50 MB, è possibile creare o aggiornare una funzione caricando il file direttamente dal computer locale. Per i file .zip di dimensioni superiori a 50 MB, prima è necessario caricare il pacchetto in un bucket Amazon S3. Per istruzioni su come caricare un file in un bucket Amazon S3 utilizzando AWS Management Console, consulta la Guida introduttiva ad Amazon S3. Per caricare file utilizzando la AWS CLI, consulta Move objects nella Guida per l'AWS CLI utente.

Aggiornamento delle funzioni dei file .zip tramite l'editor di codice della console

Per alcune funzioni con pacchetti di implementazione .zip, puoi utilizzare l'editor di codice integrato nella console Lambda per aggiornare direttamente il codice della funzione. Per utilizzare questa funzione, la funzione deve soddisfare i seguenti criteri:

Il codice della funzione per le funzioni con pacchetti di implementazione di immagini di container non può essere modificato direttamente nella console.

Creazione e aggiornamento di funzioni con file.zip utilizzando il AWS CLI

È possibile utilizzare la AWS CLI per creare una nuova funzione o aggiornare una funzione esistente mediante un file .zip. Usa la funzione create-function e update-function-codei comandi per distribuire il tuo pacchetto .zip. Se il file .zip ha dimensioni inferiori a 50 MB, è possibile caricare il pacchetto .zip da una posizione di file nella macchina di compilazione locale. Per i file di dimensioni maggiori, è necessario caricare il pacchetto .zip da un bucket Amazon S3. Per istruzioni su come caricare un file su un bucket Amazon S3 utilizzando AWS CLI, consulta Move objects nella User Guide.AWS CLI

Per creare una nuova funzione utilizzando un file.zip con AWS CLI, devi specificare quanto segue:

È inoltre necessario specificare la posizione del file .zip. Se il file .zip si trova in una cartella sulla macchina di compilazione locale, utilizza l'opzione --zip-file per specificare il percorso del file, come mostrato nel seguente comando di esempio.

aws lambda create-function --function-name myFunction \
--runtime python3.12 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--zip-file fileb://myFunction.zip

Per specificare la posizione del file .zip in un bucket Amazon S3, utilizza l'opzione --code illustrata nel seguente comando di esempio. È necessario utilizzare il parametro S3ObjectVersion solo per gli oggetti con controllo delle versioni.

aws lambda create-function --function-name myFunction \
--runtime python3.12 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--code S3Bucket=amzn-s3-demo-bucket,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

Per aggiornare una funzione esistente utilizzando ilCLI, specifichi il nome della funzione utilizzando il --function-name parametro. È inoltre necessario specificare la posizione del file .zip che desideri utilizzare per aggiornare il codice della funzione. Se il file .zip si trova in una cartella sulla macchina di compilazione locale, utilizza l'opzione --zip-file per specificare il percorso del file, come mostrato nel seguente comando di esempio.

aws lambda update-function-code --function-name myFunction \
--zip-file fileb://myFunction.zip

Per specificare la posizione del file .zip in un bucket Amazon S3, utilizza le opzioni --s3-bucket e --s3-key come illustrato nel seguente comando di esempio. È necessario utilizzare il parametro --s3-object-version solo per gli oggetti con controllo delle versioni.

aws lambda update-function-code --function-name myFunction \
--s3-bucket amzn-s3-demo-bucket --s3-key myFileName.zip --s3-object-version myObject Version

Creazione e aggiornamento di funzioni con file.zip utilizzando Lambda API

Per creare e aggiornare funzioni utilizzando un archivio di file.zip, utilizzate le seguenti operazioni: API

Creazione e aggiornamento di funzioni con file.zip utilizzando AWS SAM

Il AWS Serverless Application Model (AWS SAM) è un toolkit che aiuta a semplificare il processo di creazione ed esecuzione di applicazioni serverless su. AWS Definite le risorse per l'applicazione in un JSON modello YAML o e utilizzate l'interfaccia a riga di AWS SAM comando (AWS SAM CLI) per creare, impacchettare e distribuire le applicazioni. Quando crei una funzione Lambda da un AWS SAM modello, crea AWS SAM automaticamente un pacchetto di distribuzione.zip o un'immagine del contenitore con il codice della funzione e le eventuali dipendenze specificate. Per ulteriori informazioni sull'utilizzo AWS SAM per creare e distribuire funzioni Lambda, consulta la Guida introduttiva AWS Serverless Application Model alla AWS SAM Developer Guide.

È inoltre possibile utilizzare AWS SAM per creare una funzione Lambda utilizzando un archivio di file.zip esistente. Per creare una funzione Lambda utilizzando AWS SAM, puoi salvare il tuo file.zip in un bucket Amazon S3 o in una cartella locale sulla tua macchina di compilazione. Per istruzioni su come caricare un file su un bucket Amazon S3 utilizzando AWS CLI, consulta Move objects nella User Guide.AWS CLI

Nel AWS SAM modello, la AWS::Serverless::Function risorsa specifica la funzione Lambda. In questa risorsa, imposta le seguenti proprietà per creare una funzione utilizzando un archivio di file .zip:

Inoltre AWS SAM, se il tuo file.zip è più grande di 50 MB, non è necessario caricarlo prima in un bucket Amazon S3. AWS SAM puoi caricare pacchetti.zip fino alla dimensione massima consentita di 250 MB (decompressi) da una posizione sulla macchina di compilazione locale.

Per ulteriori informazioni sulla distribuzione delle funzioni utilizzando il file.zip in AWS SAM, consulta AWS: :Serverless: :Function nella Developer Guide.AWS SAM

Creazione e aggiornamento di funzioni con file.zip utilizzando AWS CloudFormation

È possibile utilizzare AWS CloudFormation per creare una funzione Lambda utilizzando un archivio di file.zip. Per creare una funzione Lambda da un file .zip, devi prima caricare il file su un bucket Amazon S3. Per istruzioni su come caricare un file su un bucket Amazon S3 utilizzando AWS CLI, consulta Move objects nella User Guide.AWS CLI

Per i runtime di Node.js e Python, puoi anche fornire codice sorgente in linea nel tuo modello. AWS CloudFormation AWS CloudFormation quindi crea un file.zip contenente il codice quando crei la funzione.

Utilizzo di un file .zip esistente

Nel AWS CloudFormation modello, la AWS::Lambda::Function risorsa specifica la funzione Lambda. In questa risorsa, imposta le seguenti proprietà per creare una funzione utilizzando un archivio di file .zip:

Creazione di un file .zip da codice inline

È possibile dichiarare semplici funzioni scritte in Python o Node.js in linea in un modello. AWS CloudFormation Poiché il codice è incorporato in YAML oJSON, non è possibile aggiungere dipendenze esterne al pacchetto di distribuzione. Ciò significa che la funzione deve utilizzare la versione AWS SDK di inclusa nel runtime. I requisiti del modello, come la necessità di evitare determinati caratteri, rendono inoltre più difficile l'utilizzo delle funzionalità di controllo IDE della sintassi e di completamento del codice. Ciò significa che il tuo modello potrebbe richiedere test aggiuntivi. A causa di queste limitazioni, la dichiarazione di funzioni in linea è più adatta per codice molto semplice che non cambia frequentemente.

Per creare un file .zip dal codice inline per i runtime Node.js e Python, imposta le seguenti proprietà nella risorsa del modello AWS::Lambda::Function:

Il file.zip AWS CloudFormation generato non può superare i 4 MB. Per ulteriori informazioni sulla distribuzione di funzioni utilizzando il file.zip in AWS CloudFormation, vedere AWS: :Lambda: :Function nella Guida per l'utente.AWS CloudFormation