Implementazione di funzioni Lambda per Go con gli archivi di file .zip

Nota

Il client di runtime Rust è un pacchetto sperimentale. È soggetto a modifiche ed è destinato esclusivamente a scopi di valutazione.

Questa pagina descrive come compilare la funzione Rust e quindi implementare il file binario compilato su AWS Lambda utilizzando Cargo Lambda. Mostra anche come implementare il file binario compilato con la AWS Command Line Interface e la CLI AWS Serverless Application Model.

Prerequisiti

• Rust

• AWS Command Line Interface (AWS CLI) versione 2

Compilazione di funzioni Rust su macOS, Windows o Linux

La procedura seguente mostra come creare il progetto per la prima funzione Lambda con Rust e compilarlo con Cargo Lambda.

1. Installa Cargo Lambda, un sottocomando Cargo, che compila le funzioni Rust per Lambda su macOS, Windows e Linux.

   Per installare Cargo Lambda su qualsiasi sistema in cui è installato Python 3, utilizza pip:

   pip3 install cargo-lambda

   Per installare Cargo Lambda su macOS o Linux, utilizza Homebrew:

   brew tap cargo-lambda/cargo-lambda
   brew install cargo-lambda

   Per installare Cargo Lambda su Windows, utilizza Scoop:

   scoop bucket add cargo-lambda
   scoop install cargo-lambda/cargo-lambda

   Per altre opzioni, consulta la pagina Installazione nella documentazione di Cargo Lambda.

2. Crea la struttura del pacchetto. Questo comando crea un codice di funzione di base in src/main.rs. A fini di test, puoi utilizzare questo codice o sostituirlo con il tuo codice personalizzato.

   cargo lambda new my-function

3. All'interno della directory principale del pacchetto, esegui il sottocomando build per compilare il codice nella funzione.

   cargo lambda build --release

   (Facoltativo) Se desideri utilizzare AWS Graviton2 su Lambda, aggiungi il flag --arm64 per compilare il codice per le CPU ARM.

   cargo lambda build --release --arm64

4. Prima di implementare la funzione Rust, configura le credenziali AWS sul tuo computer.

   aws configure

Implementazione del file binario di funzioni Rust con Cargo Lambda

Utilizza il sottocomando deploy per implementare il file binario compilato su Lambda. Questo comando crea un ruolo di esecuzione e quindi crea la funzione Lambda. Per specificare un ruolo di esecuzione esistente, utilizza il flag --iam-role.

cargo lambda deploy my-function

Implementazione del file binario delle funzioni Rust con la AWS CLI

Puoi implementare il file binario anche con la AWS CLI.

1. Per compilare il pacchetto di implementazione .zip, utilizza il sottocomando build.

   cargo lambda build --release --output-format zip

2. Implementa il pacchetto .zip su Lambda. Per --role, specifica l'ARN del ruolo di esecuzione.

   aws lambda create-function --function-name my-function \
        --runtime provided.al2023 \
        --role arn:aws:iam::111122223333:role/lambda-role \
        --handler rust.handler \
        --zip-file fileb://target/lambda/my-function/bootstrap.zip

Implementazione del file binario delle funzioni Rust con la CLI AWS SAM

Puoi implementare il file binario anche con la CLI AWS SAM.

1. Crea un modello AWS SAM con la definizione della risorsa e della proprietà. Per ulteriori informazioni, consulta la sezione AWS::Serverless::Function nella Guida per gli sviluppatori di AWS Serverless Application Model.

   Esempio Definizione di risorse e proprietà SAM per un file binario Rust

   AWSTemplateFormatVersion: '2010-09-09'
   Transform: AWS::Serverless-2016-10-31
   Description: SAM template for Rust binaries
   Resources:
     RustFunction:
       Type: AWS::Serverless::Function 
       Properties:
         CodeUri: target/lambda/my-function/
         Handler: rust.handler
         Runtime: provided.al2023
   Outputs:
     RustFunction:
       Description: "Lambda Function ARN"
       Value: !GetAtt RustFunction.Arn

2. Utilizza il sottocomando build per compilare la funzione.

   cargo lambda build --release

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

   sam deploy --guided

Per ulteriori informazioni sulla creazione di funzioni Rust con la CLI AWS SAM, consulta la pagina Compilazione di funzioni Lambda Rust con Cargo Lambda nella Guida per gli sviluppatori di AWS Serverless Application Model.

Richiamo della funzione Rust con Cargo Lambda

Utilizza il sottocomando invoke per testare la tua funzione con un payload.

cargo lambda invoke --remote --data-ascii '{"command": "Hello world"}' my-function

Richiamo della funzione Rust con la AWS CLI

È inoltre possibile utilizzare AWS CLI per richiamare la funzione.

aws lambda invoke --function-name my-function --cli-binary-format raw-in-base64-out --payload '{"command": "Hello world"}' /tmp/out.txt

L'opzione cli-binary-format è necessaria se si utilizza la versione 2 della AWS CLI. Per rendere questa impostazione come predefinita, esegui aws configure set cli-binary-format raw-in-base64-out. Per ulteriori informazioni, consulta la pagina AWS CLI supported global command line options nella Guida per l'utente di AWS Command Line Interface versione 2.