Import Python relatif dalam fungsi lambda Dockerized

Import Python relatif boleh menjadi rumit untuk fungsi lambda. Saya menulis blog tentang ini 3 tahun yang lalu. Tetapi baru-baru ini, saya menghadapi isu yang sama dengan fungsi lambda Dockerized. Jadi, saya fikir sudah tiba masanya untuk blog baharu!

Anda boleh mengikuti langkah-langkah tersebut atau melihat hasilnya terus di GitHub.

Persediaan projek

Pastikan anda memasang cli AWS CDK.

brew install aws-cdk

Mulakan projek:

cdk init app --language=typescript

Persediaan Lambda

Mula-mula kita perlu mencipta struktur fail dan folder:

mkdir -p lib/functions/hello-world/hello_world
touch lib/functions/hello-world/hello_world/__init__.py
touch lib/functions/hello-world/requirements.txt
touch lib/functions/hello-world/Dockerfile

Kini anda perlu mengisi Dockerfile, seperti ini:

FROM public.ecr.aws/lambda/python:3.12
COPY requirements.txt .
COPY hello_world ${LAMBDA_TASK_ROOT}/hello_world
RUN pip install --no-cache-dir -r requirements.txt
CMD ["hello_world.handler"]

Kami menggunakan imej asas Python yang berdasarkan Python 3.12. Seterusnya, kami akan menyalin dalam fail requirements.txt dan kod sumber. Kami akan memasang semua kebergantungan yang disenaraikan dalam fail requirements.txt dan memastikan kaedah pengendali ditetapkan sebagai CMD.

Seterusnya, kami perlu mengisi fail Python kami dengan beberapa kod. Dalam fail __init__.py, anda boleh meletakkan kandungan berikut:

from typing import Dict, Any


def handler(event: Dict[str, Any], context: Any) -> Dict[str, str]:
    name = event.get("name", "World")

    return {
        "Name": name,
        "Message": f"Hello {name}!",
    }


__all__ = [
    "handler"
]

NOTA: Kod yang digunakan di sini boleh menggunakan import relatif. Ini mungkin kerana ia berada dalam pakej yang berasingan. Contoh ini hanya menunjukkan kod dalam fail __init__.py. Walau bagaimanapun, anda boleh menggunakan berbilang fail di sini untuk meningkatkan kebolehselenggaraan projek anda.

Untuk contoh ini, saya tidak memerlukan sebarang kebergantungan, jadi kami boleh memastikan fail requirements.txt kosong. Saya menyertakannya dalam contoh ini untuk menggambarkan cara anda boleh memasukkan kebergantungan juga.

Cipta fungsi Lambda menggunakan IaC

Folder dan fail kami tersedia, jadi sudah tiba masanya untuk menambah fungsi Lambda pada binaan CDK. Anda hanya boleh menambahnya seperti ini:

    new lambda.Function(this, 'Function', {
      functionName: "hello-world",
      code: lambda.Code.fromAssetImage("lib/functions/hello-world", {
        platform: ecr_assets.Platform.LINUX_ARM64,
      }),
      runtime: lambda.Runtime.FROM_IMAGE,
      handler: lambda.Handler.FROM_IMAGE,
      architecture: lambda.Architecture.ARM_64,
      timeout: cdk.Duration.seconds(15),
      memorySize: 128,
    });

Untuk ini berfungsi, anda juga memerlukan import berikut:

import * as lambda from 'aws-cdk-lib/aws-lambda';
import * as ecr_assets from 'aws-cdk-lib/aws-ecr-assets';

Perhatikan bahawa kami memastikan bahawa direktori kod menghala ke direktori yang mengandungi Dockerfile dan kami memilih platform ARM untuk kedua-dua kod dan fungsi itu sendiri.

Menguji fungsi lambda secara tempatan

Maklum balas pantas adalah penting, jadi mungkin terdapat kes di mana anda perlu menjalankan kontena secara setempat. Untuk ini, anda perlu membina bekas terlebih dahulu:

docker build --platform linux/arm64 \
  -t hello-world:latest \
  -f ./lib/functions/hello-world/Dockerfile \
  ./lib/functions/hello-world

Perhatikan bahawa arahan ini boleh dilaksanakan daripada akar projek. Seterusnya, kita perlu memastikan ia berjalan sebelum kita boleh memanggilnya:

docker run --platform linux/arm64 -p 9000:8080 hello-world:latest

Selepas itu, anda boleh menggunakan fungsi seperti berikut:

curl http://localhost:9000/2015-03-31/functions/function/invocations -d '{"name": "Joris"}'

Kesimpulan

Import relatif boleh menjadi rumit! Anda perlu meletakkan kod anda dalam pakej. Ini membolehkan anda melakukan import relatif dalam pakej anda sendiri. Ini akan membolehkan kod yang lebih bersih, kerana anda boleh membahagikan tanggungjawab kepada berbilang fail, menjadikannya lebih mudah untuk diurus dan diselenggara.

Foto oleh Kaique Rocha

Atas ialah kandungan terperinci Import Python relatif dalam fungsi lambda Dockerized. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!