View a markdown version of this page

Distribuisci funzioni Lambda per Go con gli archivi di file .zip - AWS Lambda
Creazione di un file .zip su macOS e LinuxCreazione di un file .zip su WindowsCreazione e aggiornamento delle funzioni Lambda di Go utilizzando file .zip

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 tua 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 e quindi utilizzare il file .zip per distribuire il codice funzione AWS Lambda utilizzando Console di gestione AWS, AWS Command Line Interface () e ().AWS CLI AWS Serverless Application Model AWS SAM

Nota che Lambda utilizza i permessi dei file POSIX, quindi potrebbe essere necessario impostare le autorizzazioni per la cartella del pacchetto di distribuzione prima di creare l'archivio di file .zip.

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. https://github.com/aws/aws-lambda-go/tree/master/lambda GitHub Questo modulo fornisce un'implementazione dell'interfaccia di runtime, che gestisce l'interazione tra Lambda e il codice della funzione. Per scaricare questa libreria, esegui il comando seguente.

go get github.com/aws/aws-lambda-go/lambda

Se la tua funzione utilizza il AWS SDK per Go, scarica il set standard di moduli SDK, insieme a tutti i client API di AWS servizio richiesti dalla tua applicazione. Per informazioni su come installare l'SDK for Go, vedi Guida introduttiva alla AWS SDK per Go V2.

Utilizzo della famiglia di runtime forniti

Go è implementato in modo diverso rispetto ad altri runtime gestiti. Poiché Go viene compilato nativamente in un file binario eseguibile, non richiede un runtime linguistico dedicato. Usa un OS-only runtime (la famiglia provided di runtime) per distribuire le funzioni Go su Lambda.

Per creare un pacchetto di distribuzione .zip () macOS/Linux

  1. Nella directory del progetto contenente il file main.go dell'applicazione, compila il tuo eseguibile. Tenere presente quanto segue:

    • L'eseguibile deve essere denominato bootstrap. Per ulteriori informazioni, consulta Convenzioni di denominazione dei gestori.

    • Imposta l'architettura del set di istruzioni di destinazione. OS-only i runtime supportano sia arm64 che x86_64.

    • Puoi usare il tag facoltativo lambda.norpc per escludere il componente Remote Procedure Call (RPC) della libreria lambda. Il componente RPC è richiesto solo quando si utilizza il runtime Go 1.x obsoleto. L'esclusione dell'RPC riduce le dimensioni del pacchetto di implementazione.

    Per l'architettura arm64:

    GOOS=linux GOARCH=arm64 go build -tags lambda.norpc -o bootstrap main.go

    Per l'architettura x86_64:

    GOOS=linux GOARCH=amd64 go build -tags lambda.norpc -o bootstrap main.go

  2. (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.go

    Questo comando crea un pacchetto binario stabile per le versioni standard della libreria C (libc) che possono essere diverse su Lambda e su altri dispositivi.

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

  4. Crea la funzione . Tenere presente quanto segue:

    • Il file binario deve essere denominato bootstrap ma il nome del gestore può essere qualsiasi cosa. Per ulteriori informazioni, consulta Convenzioni di denominazione dei gestori.

    • L'opzione --architectures è necessaria solo se si utilizza arm64. Il valore predefinito è x86_64.

    • Per --role, specifica il nome della risorsa Amazon (ARN) del ruolo di esecuzione.

    aws lambda create-function --function-name myFunction \
--runtime provided.al2023 --handler bootstrap \
--architectures arm64 \
--role arn: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 strumento build-lambda-zip per Windows da GitHub, compilare il file eseguibile e creare un pacchetto di distribuzione .zip.

Nota

Se non è già presente, è necessario installare git e quindi aggiungere il percorso dell'eseguibile git alla variabile di ambiente di Windows %PATH%.

Prima di compilare il codice, assicurati di aver installato la libreria lambda da. https://github.com/aws/aws-lambda-go/tree/master/lambda GitHub Per scaricare questa libreria, esegui il comando seguente.

go get github.com/aws/aws-lambda-go/lambda

Se la tua funzione utilizza il AWS SDK per Go, scarica il set standard di moduli SDK, insieme a tutti i client API di AWS servizio richiesti dalla tua applicazione. Per informazioni su come installare l'SDK for Go, vedi Guida introduttiva alla AWS SDK per Go V2.

Utilizzo della famiglia di runtime forniti

Go è implementato in modo diverso rispetto ad altri runtime gestiti. Poiché Go viene compilato nativamente in un file binario eseguibile, non richiede un runtime linguistico dedicato. Usa un OS-only runtime (la famiglia provided di runtime) per distribuire le funzioni Go su Lambda.

Creazione di un pacchetto di implementazione .zip (Windows)

  1. Scarica lo strumento build-lambda-zip da. GitHub

    go install github.com/aws/aws-lambda-go/cmd/build-lambda-zip@latest

  2. 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:

    cmd.exe

    In cmd.exe, esegui una delle seguenti operazioni, a seconda dell'architettura del set di istruzioni di destinazione. Selezione e configurazione di un'architettura di set di istruzioni per la funzione Lambda OS-only i runtime supportano sia arm64 che x86_64.

    Puoi usare il tag facoltativo lambda.norpc per escludere il componente Remote Procedure Call (RPC) della libreria lambda. Il componente RPC è richiesto solo quando si utilizza il runtime Go 1.x obsoleto. L'esclusione dell'RPC riduce le dimensioni del pacchetto di implementazione.

    Esempio- Per l'architettura x86_64
    set GOOS=linux
set GOARCH=amd64
set CGO_ENABLED=0
go build -tags lambda.norpc -o bootstrap main.go
%USERPROFILE%\Go\bin\build-lambda-zip.exe -o myFunction.zip bootstrap
    Esempio- Per l'architettura arm64
    set GOOS=linux
set GOARCH=arm64
set CGO_ENABLED=0
go build -tags lambda.norpc -o bootstrap main.go
%USERPROFILE%\Go\bin\build-lambda-zip.exe -o myFunction.zip bootstrap
    PowerShell

    In PowerShell, esegui una delle seguenti operazioni, a seconda dell'architettura del set di istruzioni di destinazione. Selezione e configurazione di un'architettura di set di istruzioni per la funzione Lambda OS-only i runtime supportano sia arm64 che x86_64.

    Puoi usare il tag facoltativo lambda.norpc per escludere il componente Remote Procedure Call (RPC) della libreria lambda. Il componente RPC è richiesto solo quando si utilizza il runtime Go 1.x obsoleto. L'esclusione dell'RPC riduce le dimensioni del pacchetto di implementazione.

    Per l'architettura x86_64:

    $env:GOOS = "linux"
$env:GOARCH = "amd64"
$env:CGO_ENABLED = "0"
go build -tags lambda.norpc -o bootstrap main.go
~\Go\Bin\build-lambda-zip.exe -o myFunction.zip bootstrap

    Per l'architettura arm64:

    $env:GOOS = "linux"
$env:GOARCH = "arm64"
$env:CGO_ENABLED = "0"
go build -tags lambda.norpc -o bootstrap main.go
~\Go\Bin\build-lambda-zip.exe -o myFunction.zip bootstrap

  3. Crea la funzione . Tenere presente quanto segue:

    • Il file binario deve essere denominato bootstrap ma il nome del gestore può essere qualsiasi cosa. Per ulteriori informazioni, consulta Convenzioni di denominazione dei gestori.

    • L'opzione --architectures è necessaria solo se si utilizza arm64. Il valore predefinito è x86_64.

    • Per --role, specifica il nome della risorsa Amazon (ARN) del ruolo di esecuzione.

    aws lambda create-function --function-name myFunction \
--runtime provided.al2023 --handler bootstrap \
--architectures arm64 \
--role arn: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, l'API e Lambda. AWS Command Line Interface Puoi anche creare e aggiornare le funzioni Lambda usando AWS Serverless Application Model (AWS SAM) e 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 di Linux, Lambda richiede 644 autorizzazioni per i file non eseguibili (rw-r--r--) e 755 autorizzazioni (rwxr-xr-x) per le directory e i file eseguibili.

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 non eseguibile le autorizzazioni corrette, utilizza il comando seguente.

chmod 644 <filepath>

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

Nota

Se non concedi a Lambda le autorizzazioni necessarie per accedere alle directory del pacchetto di implementazione, Lambda imposta le autorizzazioni per tali directory su 755 (rwxr-xr-x).

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 Console di gestione AWS, consulta Guida introduttiva ad Amazon S3. Per caricare file utilizzando il AWS CLI, consulta Sposta oggetti 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)

  1. Apri la pagina Funzioni della console Lambda e scegli Crea funzione.

  2. Scegli Author from scratch (Crea da zero).

  3. In Basic information (Informazioni di base) eseguire queste operazioni:

    1. In Nome funzione, inserisci il nome della funzione.

    2. In Runtime, selezionare provided.al2023.

  4. (Opzionale) In Autorizzazioni espandere Modifica ruolo di esecuzione predefinito. Puoi creare un nuovo ruolo di esecuzione o utilizzare un ruolo esistente.

  5. Scegli Crea funzione. Lambda crea una funzione di base "Hello world" utilizzando il runtime scelto.

Caricamento di un archivio .zip dal computer locale (console)

  1. Nella pagina Funzioni della console Lambda, scegli la funzione per cui vuoi caricare il file .zip.

  2. Scegli la scheda Codice.

  3. Nel riquadro Origine del codice, scegli Carica da.

  4. Scegli File .zip.

  5. Per caricare il file .zip, procedi come segue:

    1. Seleziona Carica, quindi seleziona il tuo file .zip nel selettore di file.

    2. Seleziona Apri.

    3. Scegli Save (Salva).

Caricamento di un archivio .zip da un bucket Amazon S3 (console)

  1. Nella pagina Funzioni della console Lambda, scegli la funzione per cui vuoi caricare un nuovo file .zip.

  2. Scegli la scheda Codice.

  3. Nel riquadro Origine del codice, scegli Carica da.

  4. Scegli Posizione Amazon S3.

  5. Incolla l'URL del link Amazon S3 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. Utilizza i comandi create-function e update-function-code per implementare 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 in un bucket Amazon S3 utilizzando il AWS CLI, consulta Move objects nella Guida per l'AWS CLI utente.

Nota

Se carichi il tuo file .zip da un bucket Amazon S3 utilizzando il AWS CLI, il bucket deve trovarsi nella stessa posizione della tua funzione. Regione AWS

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)

  • Il nome della risorsa Amazon (ARN) del ruolo di esecuzione della 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 mediante la CLI, specifica il nome della funzione utilizzando il parametro --function-name. È 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 delle funzioni con file .zip utilizzando l'API Lambda

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

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

AWS Serverless Application Model (AWS SAM) è un toolkit che aiuta a semplificare il processo di creazione ed esecuzione di applicazioni serverless su. AWS Definisci le risorse per la tua applicazione in un modello YAML o JSON e usi l'interfaccia a riga di AWS SAM comando (AWS SAM CLI) per creare, impacchettare e distribuire le tue 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 dipendenze specificate. Per saperne di più sull'utilizzo AWS SAM per creare e distribuire funzioni Lambda, consulta la Guida introduttiva nella Developer Guide. AWS SAM AWS Serverless Application Model

Puoi anche usare 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 macchina di compilazione. Per istruzioni su come caricare un file in un bucket Amazon S3 utilizzando il AWS CLI, consulta Move objects nella Guida per l'utente. 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 su Zip

  • CodeUri- impostato sull'URI Amazon S3, sul percorso della cartella locale o sull'oggetto del codice funzione FunctionCode

  • Runtime: imposta il runtime prescelto

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

Per saperne di più 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

  1. 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]

  2. Usa il comando sam build per compilare l'eseguibile.

    sam build

  3. Utilizza il comando sam deploy per implementare la funzione su Lambda.

    sam deploy --guided

Creazione e aggiornamento di funzioni con file .zip utilizzando CloudFormation

È possibile utilizzare 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 in un bucket Amazon S3 utilizzando AWS CLI, consulta Move objects nella Guida per l'utente. AWS CLI

Nel 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 su Zip

  • Code: inserisci il nome del bucket Amazon S3 e il nome del file .zip nei campi S3Bucket e S3Key

  • Runtime: imposta il runtime prescelto

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