Warstwowe Lambdy: AWS SAM i Python

Nieco ponownego wykorzystania kodu nigdy nie szkodzi

Page content

Oto krok po kroku instrukcje, jak dodać warstwy do AWS Lambdas - w Pythonie. Będziemy korzystać z podstawowego kodu wygenerowanego przez standardowy przykład szablonu HelloWorld.

letters-layers

I tak, oczywiście potrzebujesz wszystkiego, co ma się do Pythona i rzeczy z AWS SAM zainstalowanych i skonfigurowanych.

Generowanie i uruchamianie projektu przykładowego

Teraz wywołaj sam init i odpowiedz na pytania standardowo, tak jak poniżej:

sam-init-answers

pokaże podsumowanie

sam-init-summary

i utworzy folder projektu z strukturą i niektórymi plikami. template.yaml jest dość standardowy.

vs-code-template-yaml

oraz kod funkcji również (usunięte zostaną dodatkowe komentarze)

import json

def lambda_handler(event, context):

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

Teraz zbudujmy i wywołajmy tę funkcję lokalnie

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

Koniec odpowiedzi powinien być zbliżony do poniższego:

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

Dodawanie warstwy

Dodaj opis warstwy do template.yaml

Dwa fragmenty:

  • ApiSharedLayer - blok opisujący ją
  • Layers: … - !Ref ApiSharedLayer - w funkcji, która ją wykorzystuje
.....
Resources:
# added code start
    ApiSharedLayer:
        Type: AWS::Serverless::LayerVersion
        Properties:
            ContentUri: api_shared_layer/
            LayerName: api-shared-layer
            Description: Moja warstwa api-shared-layer
            CompatibleRuntimes:
                - python3.9
            RetentionPolicy: Delete                
        Metadata:
            BuildMethod: python3.9   # Wymagane, aby AWS SAM zbudował tę warstwę
# added code end

  HelloWorldFunction:
    Type: AWS::Serverless::Function # Więcej informacji o zasobie 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:
.....

Dodaj kod warstwy

do folderu api_shared_layer dodaj pewien kod

layer code

Zaktualizuj funkcję, aby użyć tego kodu

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
        }),
    }

Uruchomienie testowe

Znowu:

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

Koniec odpowiedzi powinien być zbliżony do poniższego:

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

Świetnie.

Przydatne linki