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à.
Distribuisci funzioni Lambda per Go con gli archivi di file .zip
Il codice della AWS Lambda funzione è costituito da script o programmi compilati e dalle relative dipendenze. Utilizza un pacchetto di implementazione per distribuire il codice della funzione a Lambda. Lambda supporta due tipi di pacchetti di implementazione: immagini di container e archivi di file .zip.
Questa pagina descrive come creare un file.zip come pacchetto di distribuzione per il runtime Go, quindi utilizzare il file.zip per distribuire il codice della funzione su AWS Management Console, AWS Command Line Interface (AWS CLI) e (). AWS Lambda AWS Serverless Application Model AWS SAM
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
Sections
Creazione di un file .zip su macOS e Linux
I passaggi seguenti mostrano come compilare il file eseguibile utilizzando il comando go build
e creare un pacchetto di implementazione con file .zip per Lambda. Prima di compilare il codice, assicurati di aver installato il pacchetto lambda da.
go get github.com/aws/aws-lambda-go/lambda
Se la tua funzione utilizza il AWS SDK for Go, scarica il set standard di SDK moduli, insieme a tutti API i client AWS di servizio richiesti dall'applicazione. Per informazioni su come installare SDK for Go, consulta Guida introduttiva alla AWS SDK for Go versione 2
Utilizzo della famiglia di runtime fornita
Go è implementato in modo diverso rispetto ad altri runtime gestiti. Poiché Go viene compilato in modo nativo in un file binario eseguibile, non richiede un runtime linguistico dedicato. Usa un runtime solo per il sistema operativo (la famiglia provided
di runtime) per distribuire le funzioni Go in Lambda.
Creazione di un pacchetto di implementazione .zip (macOS/Linux)
-
Nella directory del progetto contenente il file
main.go
dell'applicazione, compila il tuo eseguibile. Tieni presente quanto segue:-
L'eseguibile deve essere denominato
bootstrap
. Per ulteriori informazioni, consulta Denominazione. -
Imposta l'architettura del set di istruzioni di destinazione. I runtime solo per il sistema operativo supportano sia arm64 che x86_64.
-
È possibile utilizzare il
lambda.norpc
tag opzionale per escludere il componente Remote Procedure Call () RPC della libreria lambda.Il RPC componente è necessario solo se si utilizza il runtime Go 1.x obsoleto. L'esclusione di RPC riduce le dimensioni del pacchetto di distribuzione.
Per l'architettura arm64:
GOOS=linux GOARCH=
arm64
go build -tags lambda.norpc -o bootstrap main.goPer l'architettura x86_64:
GOOS=linux GOARCH=
amd64
go build -tags lambda.norpc -o bootstrap main.go -
-
(Opzionale) Potrebbe essere necessario compilare pacchetti con
CGO_ENABLED=0
impostato su Linux:GOOS=linux GOARCH=
arm64
CGO_ENABLED=0 go build -o bootstrap -tags lambda.norpc main.goQuesto comando crea un pacchetto binario stabile per le versioni standard della libreria C (
libc
) che possono essere diverse su Lambda e su altri dispositivi. -
Crea un pacchetto di distribuzione comprimendo l'eseguibile in un file .zip.
zip myFunction.zip bootstrap
Nota
Il file
bootstrap
deve trovarsi nella posizione root del file .zip. -
Crea la funzione . Tieni presente quanto segue:
-
Il file binario deve essere denominato
bootstrap
ma il nome del gestore può essere qualsiasi cosa. Per ulteriori informazioni, consulta Denominazione. -
L'opzione
--architectures
è necessaria solo se si utilizza arm64. Il valore predefinito è x86_64. -
Per
--role
, specifica l'Amazon Resource Name (ARN) del ruolo di esecuzione.
aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler
bootstrap
\ --architecturesarm64
\ --rolearn:aws:iam::111122223333:role/lambda-ex
\ --zip-file fileb://myFunction.zip -
Creazione di un file .zip su Windows
I passaggi seguenti mostrano come scaricare lo build-lambda-zip
Nota
Se non è già presente, è necessario installare gitgit
alla variabile di ambiente di Windows %PATH%
.
Prima di compilare il codice, assicurati di aver installato la libreria lambda
go get github.com/aws/aws-lambda-go/lambda
Se la tua funzione utilizza il AWS SDK for Go, scarica il set standard di SDK moduli, insieme a tutti API i client AWS di servizio richiesti dall'applicazione. Per informazioni su come installare SDK for Go, consulta Guida introduttiva alla AWS SDK for Go versione 2
Utilizzo della famiglia di runtime fornita
Go è implementato in modo diverso rispetto ad altri runtime gestiti. Poiché Go viene compilato in modo nativo in un file binario eseguibile, non richiede un runtime linguistico dedicato. Usa un runtime solo per il sistema operativo (la famiglia provided
di runtime) per distribuire le funzioni Go in Lambda.
Creazione di un pacchetto di implementazione .zip (Windows)
-
Scarica lo strumento da. build-lambda-zip GitHub
go install github.com/aws/aws-lambda-go/cmd/build-lambda-zip@latest
-
Utilizza lo strumento dal tuo
GOPATH
per creare un file .zip. Se si dispone di un'installazione predefinita di Go, lo strumento si trova solitamente in%USERPROFILE%\Go\bin
. Altrimenti, vai alla posizione in cui è stato installato il runtime Go ed esegui una delle seguenti operazioni: -
Crea la funzione . Tieni presente quanto segue:
-
Il file binario deve essere denominato
bootstrap
ma il nome del gestore può essere qualsiasi cosa. Per ulteriori informazioni, consulta Denominazione. -
L'opzione
--architectures
è necessaria solo se si utilizza arm64. Il valore predefinito è x86_64. -
Per
--role
, specifica l'Amazon Resource Name (ARN) del ruolo di esecuzione.
aws lambda create-function --function-name myFunction \ --runtime provided.al2023 --handler
bootstrap
\ --architecturesarm64
\ --rolearn:aws:iam::111122223333:role/lambda-ex
\ --zip-file fileb://myFunction.zip -
Creazione e aggiornamento delle funzioni Lambda di Go utilizzando file .zip
Dopo aver creato il pacchetto di implementazione .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
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 il 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.
Nota
Non è possibile convertire una funzione di immagine di container esistente per utilizzare un archivio .zip. È necessario creare una nuova funzione.
Creazione di una nuova funzione (console)
-
Apri la pagina Funzioni
della console Lambda e scegli Crea funzione. -
Scegli Author from scratch (Crea da zero).
-
In Basic information (Informazioni di base) eseguire queste operazioni:
-
In Nome funzione, inserisci il nome della funzione.
-
In Runtime, selezionare
provided.al2023
.
-
-
(Opzionale) In Autorizzazioni espandere Modifica ruolo di esecuzione predefinito. Puoi creare un nuovo ruolo di esecuzione o utilizzare un ruolo esistente.
-
Scegli Crea funzione. Lambda crea una funzione di base "Hello world" utilizzando il runtime scelto.
Caricamento di un archivio .zip dal computer locale (console)
-
Nella pagina Funzioni
della console Lambda, scegli la funzione per cui vuoi caricare il file .zip. -
Scegli la scheda Codice.
-
Nel riquadro Origine del codice, scegli Carica da.
-
Scegli File .zip.
-
Per caricare il file .zip, procedi come segue:
-
Seleziona Carica, quindi seleziona il tuo file .zip nel selettore di file.
-
Seleziona Apri.
-
Seleziona Salva.
-
Caricamento di un archivio .zip da un bucket Amazon S3 (console)
-
Nella pagina Funzioni
della console Lambda, scegli la funzione per cui vuoi caricare un nuovo file .zip. -
Scegli la scheda Codice.
-
Nel riquadro Origine del codice, scegli Carica da.
-
Scegli Posizione Amazon S3.
-
Incolla il link Amazon S3 URL del tuo file.zip e scegli Salva.
Creazione e aggiornamento di funzioni con file.zip utilizzando 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
Nota
Se carichi il tuo file.zip da un bucket Amazon S3 utilizzando AWS CLI il, il bucket deve trovarsi nella stessa posizione della Regione AWS tua funzione.
Per creare una nuova funzione utilizzando un file.zip con AWS CLI, devi specificare quanto segue:
-
Il nome della funzione (
--function-name
) -
Il runtime della tua funzione (
--runtime
) -
L'Amazon Resource Name (ARN) del ruolo di esecuzione della tua funzione (
--role
) -
Il nome del metodo del gestore nel codice della funzione (
--handler
)
È 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 provided.al2023 --handler bootstrap \ --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 provided.al2023 --handler bootstrap \ --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:
-
PackageType
: imposta il valore suZip
-
CodeUri
- impostato sull'Amazon S3 del codice della funzioneURI, sul percorso della cartella locale o sull'oggetto FunctionCode -
Runtime
: imposta il runtime prescelto
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
Esempio: utilizzo AWS SAM per creare una funzione Go con provided.al2023
-
Crea un AWS SAM modello con le seguenti proprietà:
-
BuildMethod: specifica il compilatore per l'applicazione. Utilizza
go1.x
. -
Runtime: utilizza
provided.al2023
. -
CodeUri: inserisci il percorso del codice.
-
Architetture: usa
[arm64]
per l'architettura arm64. Per l'architettura del set di istruzioni x86_64, utilizza[amd64]
oppure rimuovi la proprietàArchitectures
.
Esempio template.yaml
AWSTemplateFormatVersion: '2010-09-09' Transform: 'AWS::Serverless-2016-10-31' Resources: HelloWorldFunction: Type: AWS::Serverless::Function Metadata: BuildMethod:
go1.x
Properties: CodeUri:hello-world/
# folder where your main program resides Handler: bootstrap Runtime:provided.al2023
Architectures:[arm64]
-
-
Usa il comando sam build per compilare l'eseguibile.
sam build
-
Utilizza il comando sam deploy per implementare la funzione su Lambda.
sam deploy --guided
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
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:
-
PackageType
: imposta il valore suZip
-
Code
: inserisci il nome del bucket Amazon S3 e il nome del file .zip nei campiS3Bucket
eS3Key
-
Runtime
: imposta il runtime prescelto
Il file.zip che AWS CloudFormation genera 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
Creazione di un livello Go per dipendenze
Nota
L’utilizzo di livelli con funzioni in un linguaggio compilato come Go potrebbe non offrire gli stessi vantaggi di un linguaggio interpretato come Python. Siccome Go è un linguaggio compilato, le funzioni devono comunque caricare manualmente gli assembly condivisi in memoria durante la fase di inizializzazione, per cui i tempi di avvio a freddo possono aumentare. È preferibile, invece, includere qualunque codice condiviso in fase di compilazione per sfruttare le ottimizzazioni integrate del compilatore.
Le istruzioni in questa sezione spiegano come includere dipendenze in un livello.
Lambda rileva automaticamente tutte le librerie nella directory /opt/lib
e tutti i file binari nella directory /opt/bin
. Per accertarti che Lambda trovi correttamente il contenuto del tuo livello, crea un livello con la seguente struttura:
custom-layer.zip └ lib | lib_1 | lib_2 └ bin | bin_1 | bin_2
Dopo aver creato un pacchetto del livello, consulta Creazione ed eliminazione di livelli in Lambda e Aggiunta di livelli alle funzioni per completare l’impostazione del livello.