Tutorial: criar um runtime personalizado

Para criar uma função de execução

1. Abra a página Roles (Funções) no console do IAM.

2. Selecione Criar perfil.

3. Crie uma função com as propriedades a seguir.

   • Entidade confiável–Lambda.

   • Permissions (Permissões): AWSLambdaBasicExecutionRole.

   • Role name (Nome da função): lambda-role.

   A política AWSLambdaBasicExecutionRole tem as permissões necessárias para a função gravar logs no CloudWatch Logs.

1. Crie um diretório para o projeto e depois mude para esse diretório.

   mkdir runtime-tutorial
   cd runtime-tutorial

2. Crie um novo arquivo chamado bootstrap. Esse é o runtime personalizado.

   exemplo 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

   O runtime carrega um script de função do pacote de implantação. Ele usa duas variáveis para localizar o script. LAMBDA_TASK_ROOT informa onde o pacote foi extraído e _HANDLER inclui o nome do script.

   Depois que o runtime carrega o script da função, ele usa a API de runtime para recuperar um evento de invocação do Lambda, transmite o evento para o manipulador e publica a resposta de volta no Lambda. Para obter o ID de solicitação, o runtime salva os cabeçalhos na resposta da API em um arquivo temporário e lê o cabeçalho Lambda-Runtime-Aws-Request-Id do arquivo.

   nota

   Os runtimes têm responsabilidades adicionais, incluindo o processamento de erros e o fornecimento de informações de contexto para o manipulador. Para obter detalhes, consulte Requisitos.

3. Crie um script para a função. O exemplo de script a seguir define uma função do manipulador que usa dados de eventos, os registra no log stderr e os retorna.

   exemplo function.sh

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

   Agora, diretório runtime-tutorial será desta forma:

   runtime-tutorial
   ├ bootstrap
   └ function.sh

4. Torne os arquivos executáveis e os adicione a um arquivo .zip. Esse é o pacote de implantação.

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

5. Crie uma função chamada bash-runtime. Para --role, insira o ARN do seu perfil de execução do 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. Invoque a função.

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

   A opção cli-binary-format será necessária se você estiver usando a AWS CLI versão 2. Para que essa seja a configuração padrão, execute aws configure set cli-binary-format raw-in-base64-out. Para obter mais informações, consulte A AWS CLI comporta opções de linha de comando globais no Guia do usuário da AWS Command Line Interface versão 2.

   Você obterá uma resposta parecida com esta:

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

7. Verifique a resposta.

   cat response.txt

   Você obterá uma resposta parecida com esta:

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

1. Crie um arquivo .zip que contenha o arquivo bootstrap.

   zip runtime.zip bootstrap

2. Crie uma camada com o comando publish-layer-version.

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

   Isso cria a primeira versão da camada.

1. Atualize a configuração de função para extrair na camada.

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

   Isso adiciona o runtime à função no diretório /opt. Para garantir que o Lambda use o runtime na camada, você precisa remover o boostrap do pacote de implantação da função, conforme mostrado nas próximas duas etapas.

2. Crie um arquivo .zip que contenha o código da função.

   zip function-only.zip function.sh

3. Atualize o código da função para incluir apenas o script do manipulador.

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

4. Invoque a função para confirmar se ela funciona com a camada de runtime.

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

   A opção cli-binary-format será necessária se você estiver usando a AWS CLI versão 2. Para que essa seja a configuração padrão, execute aws configure set cli-binary-format raw-in-base64-out. Para obter mais informações, consulte A AWS CLI comporta opções de linha de comando globais no Guia do usuário da AWS Command Line Interface versão 2.

   Você obterá uma resposta parecida com esta:

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

5. Verifique a resposta.

   cat response.txt

   Você obterá uma resposta parecida com esta:

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

1. Para registrar informações sobre o ambiente de execução, atualize o script de runtime para gerar variáveis de ambiente.

   exemplo 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. Crie um arquivo .zip que contenha a nova versão do arquivo bootstrap.

   zip runtime.zip bootstrap

3. Crie uma nova versão da camada bash-runtime.

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

4. Configure a função para usar a nova versão da camada.

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