Lambda em Camadas: AWS SAM e Python

Um pouco de reutilização de código nunca faz mal.

Conteúdo da página

Estas são as instruções passo a passo sobre como adicionar camadas a AWS Lambdas - em Python. Vamos utilizar o código base gerado pelo exemplo do modelo padrão HelloWorld.

letters-layers

E sim, claro que você precisa ter todos os Python e coisas do AWS SAM pré-instalados e configurados.

Gerando e executando um projeto de exemplo

Agora, execute sam init e responda às perguntas da forma padrão, assim:

sam-init-answers

ele mostrará o resumo

sam-init-summary

e criará a pasta do projeto com a estrutura e alguns arquivos. O template.yaml é bastante padrão.

vs-code-template-yaml

e o código da função também (vou limpar os comentários gerados extras)

import json

def lambda_handler(event, context):

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

Agora vamos construir e chamar essa função localmente

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

O final da resposta deve estar próximo ao abaixo:

.....
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\"}"}

Adicionando a camada

Adicionar a descrição da camada ao template.yaml

Dois pontos:

  • ApiSharedLayer - bloco que a descreve
  • Layers: … - !Ref ApiSharedLayer - na função que a utiliza
.....
Resources:
# added code start
    ApiSharedLayer:
        Type: AWS::Serverless::LayerVersion
        Properties:
            ContentUri: api_shared_layer/
            LayerName: api-shared-layer
            Description: Minha camada compartilhada de API
            CompatibleRuntimes:
                - python3.9
            RetentionPolicy: Delete                
        Metadata:
            BuildMethod: python3.9   # Necessário para que o AWS SAM construa esta camada
# added code end

  HelloWorldFunction:
    Type: AWS::Serverless::Function # Mais informações sobre o 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:
.....

Adicionar o código da camada

dentro da pasta api_shared_layer adicione algum código

layer code

Atualizar a função para utilizar 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
        }),
    }

Execução de teste

Novamente:

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

O final da resposta deve estar próximo ao abaixo:

.....
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\"}"}

Legal.