Tutorial: Creazione di un runtime personalizzato

Creazione di un ruolo di esecuzione

1. Apri la pagina dei ruoli nella IAM console.

2. Scegliere Crea ruolo.

3. Creare un ruolo con le seguenti proprietà.

   • Trusted entity (Entità attendibile – Lambda

   • Autorizzazioni — AWSLambdaBasicExecutionRole.

   • Nome ruolo – lambda-role.

   La AWSLambdaBasicExecutionRolepolitica dispone delle autorizzazioni necessarie alla funzione per scrivere i log in Logs. CloudWatch

1. Crea una directory per il progetto, quindi passa a quella directory.

   mkdir runtime-tutorial
   cd runtime-tutorial

2. Crea un nuovo file denominato bootstrap. Questo è il runtime personalizzato.

   Esempio bootstrap

   #!/bin/sh
   
   set -euo pipefail
   
   # Initialization - load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

   Il runtime carica uno script di funzione dal pacchetto di distribuzione. Utilizza due variabili per individuare lo script. LAMBDA_TASK_ROOT indica il percorso da cui il pacchetto è stato estratto e _HANDLER include il nome dello script.

   Dopo che il runtime ha caricato lo script della funzione, utilizza il runtime API per recuperare un evento di chiamata da Lambda, lo passa al gestore e invia la risposta a Lambda. Per ottenere l'ID della richiesta, il runtime salva le intestazioni della API risposta in un file temporaneo e legge l'intestazione dal file. Lambda-Runtime-Aws-Request-Id

   Nota

   I runtime hanno responsabilità aggiuntive inclusa la gestione degli errori e forniscono al gestore le informazioni sul contesto. Per informazioni dettagliate, consultare Requisiti.

3. Crea uno script per la funzione. Lo script di esempio seguente definisce una funzione del gestore che richiede i dati dell'evento, li registra in stderr e li restituisce.

   Esempio function.sh

   function handler () {
     EVENT_DATA=$1
     echo "$EVENT_DATA" 1>&2;
     RESPONSE="Echoing request: '$EVENT_DATA'"
   
     echo $RESPONSE
   }

   L'aspetto della directory runtime-tutorial dovrebbe essere simile al seguente:

   runtime-tutorial
   ├ bootstrap
   └ function.sh

4. Rendere i file eseguibili e aggiungerli ad un archive ZIP. Questo è il pacchetto di implementazione.

   chmod 755 function.sh bootstrap
   zip function.zip function.sh bootstrap

5. Crea una funzione denominata bash-runtime. Per--role, inserisci il tuo ARN ruolo di esecuzione Lambda.

   aws lambda create-function --function-name bash-runtime \
   --zip-file fileb://function.zip --handler function.handler --runtime provided.al2023 \
   --role arn:aws:iam::123456789012:role/lambda-role

6. Richiama la funzione.

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   L'cli-binary-formatopzione è obbligatoria se utilizzi la AWS CLI versione 2. 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.

   Dovresti ottenere una risposta simile a questa:

   {
       "StatusCode": 200,
       "ExecutedVersion": "$LATEST"
   }

7. Verifica la risposta.

   cat response.txt

   Dovresti ottenere una risposta simile a questa:

   Echoing request: '{"text":"Hello"}'

1. Crea un file .zip contenente il file bootstrap.

   zip runtime.zip bootstrap

2. Crea un livello con il publish-layer-versioncomando.

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

   In tal modo viene creata la prima versione del livello.

1. Aggiorna la configurazione della funzione da inserire nel livello.

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:1

   Questo aggiunge il runtime alla funzione nella directory /opt. Per garantire che Lambda utilizzi il runtime nel livello, è necessario rimuovere il boostrap dal pacchetto di implementazione della funzione, come illustrato nei due passaggi successivi.

2. Crea un file .zip contenente il codice della funzione.

   zip function-only.zip function.sh

3. Aggiorna il codice della funzione in modo da includere soltanto lo script del gestore.

   aws lambda update-function-code --function-name bash-runtime --zip-file fileb://function-only.zip

4. Chiama la funzione per verificare che funzioni con il livello del runtime.

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   L'cli-binary-formatopzione è obbligatoria se si utilizza la AWS CLI versione 2. 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.

   Dovresti ottenere una risposta simile a questa:

   {
       "StatusCode": 200,
       "ExecutedVersion": "$LATEST"
   }

5. Verifica la risposta.

   cat response.txt

   Dovresti ottenere una risposta simile a questa:

   Echoing request: '{"text":"Hello"}'

1. Per registrare le informazioni sull'ambiente di esecuzione, aggiorna lo script del runtime sulle variabili di ambiente di output.

   Esempio bootstrap

   #!/bin/sh
   
   set -euo pipefail
   
   # Configure runtime to output environment variables
   echo "##  Environment variables:"
   env
   
   # Load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

2. Crea un file .zip contenente la nuova versione del file bootstrap.

   zip runtime.zip bootstrap

3. Crea una nuova versione del livello bash-runtime.

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

4. Configura la funzione per utilizzare la nuova versione del livello.

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:2