Lambda con capas: AWS SAM y Python

Un poco de reutilización de código nunca hace daño.

Índice

Estas son las instrucciones paso a paso sobre cómo añadir capas a AWS Lambdas - en Python. Se utilizará el código base generado por el ejemplo de plantilla HelloWorld estándar.

letters-layers

Y sí, por supuesto, necesitas tener instalado todo Python y las cosas de AWS SAM preinstaladas y configuradas.

Generando y ejecutando un proyecto de ejemplo

Ahora llama a sam init y responde a las preguntas de la manera estándar, así:

sam-init-answers

mostrará el resumen

sam-init-summary

y creará la carpeta del proyecto con la estructura y algunos archivos. El archivo template.yaml es bastante estándar.

vs-code-template-yaml

y el código de la función también (limpiaré los comentarios generados adicionales)

import json

def lambda_handler(event, context):

    return {
        "statusCode": 200,
        "body": json.dumps({
            "message": "hello world",
            # "location": ip.text.replace("\n", "")
        }),
    }

Ahora construyamos y ejecutemos esta función localmente

sam validate && sam build --use-container && sam local invoke HelloWorldFunction --event events/event.json

El final de la respuesta debe ser similar al siguiente:

.....
START RequestId: 6da35464-7c6a-40b2-bcc0-60796994317a Version: $LATEST
END RequestId: 737ae28d-2b99-49e6-baae-40ab9bb99599
REPORT RequestId: 737ae28d-2b99-49e6-baae-40ab9bb99599  Init Duration: 0.04 ms  Duration: 28.40 ms      Billed Duration: 29 ms  Memory Size: 128 MB     Max Memory Used: 128 MB
{"statusCode": 200, "body": "{\"message\": \"hello world\"}"}

Añadiendo la capa

Añadir la descripción de la capa a template.yaml

Dos partes:

  • ApiSharedLayer - bloque que la describe
  • Layers: … - !Ref ApiSharedLayer - en la función que la utiliza
.....
Resources:
# added code start
    ApiSharedLayer:
        Type: AWS::Serverless::LayerVersion
        Properties:
            ContentUri: api_shared_layer/
            LayerName: api-shared-layer
            Description: Mi api-shared-layer
            CompatibleRuntimes:
                - python3.9
            RetentionPolicy: Delete                
        Metadata:
            BuildMethod: python3.9   # Requerido para que AWS SAM construya esta capa
# added code end

  HelloWorldFunction:
    Type: AWS::Serverless::Function # Más información sobre el recurso Function: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
    Properties:
      CodeUri: hello_world/
      Handler: app.lambda_handler
      Runtime: python3.9
      Architectures:
        - x86_64
# added code start
      Layers:
        - !Ref ApiSharedLayer
# added code end
      Events:
.....

Añadir el código de la capa

dentro de la carpeta api_shared_layer añade algún código

layer code

Actualizar la función para usar este código

import json
from api_version import API_VERSION

def lambda_handler(event, context):

    return {
        "statusCode": 200,
        "body": json.dumps({
            "message": "hello world",
            "version": API_VERSION
        }),
    }

Ejecución de prueba

De nuevo:

sam validate && sam build --use-container && sam local invoke HelloWorldFunction --event events/event.json

El final de la respuesta debe ser similar al siguiente:

.....
START RequestId: 88eb1887-ae94-479d-a059-f87c4b71a282 Version: $LATEST
END RequestId: 927f7d05-4d13-44ba-9377-03e6d3e8bacf
REPORT RequestId: 927f7d05-4d13-44ba-9377-03e6d3e8bacf  Init Duration: 0.72 ms  Duration: 34.80 ms      Billed Duration: 35 ms  Memory Size: 128 MB     Max Memory Used: 128 MB
{"statusCode": 200, "body": "{\"message\": \"hello world\", \"version\": \"1.1.1\"}"}

Bueno.

Enlaces útiles