Bekerja dengan lapisan untuk fungsi Lambda Python

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Lapisan Lambda adalah arsip file.zip yang berisi kode atau data tambahan. Lapisan biasanya berisi dependensi pustaka, runtime kustom, atau file konfigurasi. Membuat layer melibatkan tiga langkah umum:

Topik ini berisi langkah-langkah dan panduan tentang cara mengemas dan membuat lapisan Lambda Python dengan dependensi pustaka eksternal dengan benar.

Prasyarat

Untuk mengikuti langkah-langkah di bagian ini, Anda harus memiliki yang berikut:

Sepanjang topik ini, kami mereferensikan layer-pythoncontoh aplikasi pada repositori awsdocs GitHub . Aplikasi ini berisi skrip yang mengunduh dependensi dan menghasilkan lapisan. Aplikasi ini juga berisi fungsi terkait yang menggunakan dependensi dari lapisan. Setelah membuat layer, Anda dapat menerapkan dan memanggil fungsi yang sesuai untuk memverifikasi bahwa semuanya berfungsi dengan baik. Runtime layer harus kompatibel dengan runtime fungsi. Misalnya, jika Anda menggunakan runtime Python 3.13 untuk fungsi Anda, layer Anda juga harus kompatibel dengan Python 3.13.

Dalam aplikasi layer-python sampel, ada dua contoh:

Kompatibilitas lapisan Python dengan Amazon Linux

Langkah pertama untuk membuat layer adalah untuk menggabungkan semua konten layer Anda ke dalam arsip file.zip. Karena fungsi Lambda berjalan di Amazon Linux, konten layer Anda harus dapat dikompilasi dan dibangun di lingkungan Linux.

Dalam Python, sebagian besar paket tersedia sebagai roda (.whlfile) selain distribusi sumber. Setiap roda adalah jenis distribusi yang dibangun yang mendukung kombinasi spesifik dari versi Python, sistem operasi, dan set instruksi mesin.

Roda berguna untuk memastikan bahwa lapisan Anda kompatibel dengan Amazon Linux. Saat Anda mengunduh dependensi Anda, unduh roda universal jika memungkinkan. (Secara default, pip pasang roda universal jika tersedia.) Roda universal berisi any sebagai tag platform, yang menunjukkan bahwa itu kompatibel dengan semua platform, termasuk Amazon Linux.

Dalam contoh berikut, Anda mengemas requests pustaka ke dalam lapisan Lambda. requestsPerpustakaan adalah contoh paket yang tersedia sebagai roda universal.

Tidak semua paket Python didistribusikan sebagai roda universal. Misalnya, numpymemiliki beberapa distribusi roda, masing-masing mendukung serangkaian platform yang berbeda. Untuk paket seperti itu, unduh manylinux distribusi untuk memastikan kompatibilitas dengan Amazon Linux. Untuk petunjuk terperinci tentang cara mengemas lapisan tersebut, lihatBekerja dengan distribusi manylinux roda.

Dalam kasus yang jarang terjadi, paket Python mungkin tidak tersedia sebagai roda. Jika hanya distribusi sumber (sdist) yang ada, maka kami sarankan untuk menginstal dan mengemas dependensi Anda di lingkungan Docker berdasarkan image wadah dasar Amazon Linux 2023. Kami juga merekomendasikan pendekatan ini jika Anda ingin menyertakan pustaka kustom Anda sendiri yang ditulis dalam bahasa lain seperti C/C++. Pendekatan ini meniru lingkungan eksekusi Lambda di Docker, dan memastikan bahwa dependensi paket non-Python Anda kompatibel dengan Amazon Linux.

Jalur lapisan untuk runtime Python

Saat Anda menambahkan lapisan ke fungsi, Lambda memuat konten lapisan ke dalam /opt direktori lingkungan eksekusi itu. Untuk setiap runtime Lambda, PATH variabel sudah menyertakan jalur folder tertentu dalam direktori. /opt Untuk memastikan bahwa Lambda mengambil konten layer Anda, file layer.zip Anda harus memiliki dependensinya di jalur folder berikut:

Misalnya, file layer .zip yang dihasilkan yang Anda buat dalam tutorial ini memiliki struktur direktori berikut:

layer_content.zip
└ python
    └ lib
        └ python3.13
            └ site-packages
                └ requests
                └ <other_dependencies> (i.e. dependencies of the requests package)
                └ ...

requestsPerpustakaan terletak dengan benar di python/lib/python3.13/site-packages direktori. Ini memastikan bahwa Lambda dapat menemukan pustaka selama pemanggilan fungsi.

Mengemas konten lapisan

Dalam contoh ini, Anda mengemas requests pustaka Python dalam file layer .zip. Selesaikan langkah-langkah berikut untuk menginstal dan mengemas konten lapisan.

Membuat layer

Di bagian ini, Anda mengambil layer_content.zip file yang Anda buat di bagian sebelumnya dan mengunggahnya sebagai lapisan Lambda. Anda dapat mengunggah layer menggunakan AWS Management Console atau Lambda API melalui AWS Command Line Interface ()AWS CLI. Saat Anda mengunggah file layer .zip Anda, dalam PublishLayerVersion AWS CLI perintah berikut, tentukan python3.13 sebagai runtime yang kompatibel dan arm64 sebagai arsitektur yang kompatibel.

aws lambda publish-layer-version --layer-name python-requests-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes python3.13 \
    --compatible-architectures "arm64"

Dari tanggapan, perhatikanLayerVersionArn, yang terlihat sepertiarn:aws:lambda:us-east-1:123456789012:layer:python-requests-layer:1. Anda akan memerlukan Amazon Resource Name (ARN) ini di langkah berikutnya dari tutorial ini, ketika Anda menambahkan layer ke fungsi Anda.

Menambahkan layer ke fungsi Anda

Di bagian ini, Anda menerapkan contoh fungsi Lambda yang menggunakan requests pustaka dalam kode fungsinya, lalu Anda melampirkan layer. Untuk menerapkan fungsi, Anda memerlukan peran eksekusi. Jika Anda tidak memiliki peran eksekusi yang ada, ikuti langkah-langkah di bagian yang dapat dilipat.

Kode fungsi Lambda mengimpor requests pustaka, membuat permintaan HTTP sederhana, dan kemudian mengembalikan kode status dan badan.

import requests

def lambda_handler(event, context):
    print(f"Version of requests library: {requests.__version__}")
    request = requests.get('https://api.github.com/')
    return {
        'statusCode': request.status_code,
        'body': request.text
    }

Bekerja dengan distribusi manylinux roda

Terkadang, paket yang ingin Anda sertakan sebagai dependensi tidak akan memiliki roda universal (khususnya, tidak memiliki any tag platform). Dalam hal ini, unduh roda yang mendukung manylinux sebagai gantinya. Ini memastikan bahwa pustaka lapisan Anda kompatibel dengan Amazon Linux.

numpyadalah salah satu paket yang tidak memiliki roda universal. Jika Anda ingin menyertakan numpy paket di layer Anda, maka Anda dapat menyelesaikan langkah-langkah contoh berikut untuk menginstal dan mengemas layer Anda dengan benar.

Untuk mengunggah layer ini ke Lambda, gunakan perintah berikut: PublishLayerVersion AWS CLI

aws lambda publish-layer-version --layer-name python-numpy-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes python3.11 \
    --compatible-architectures "x86_64"

Dari tanggapan, perhatikanLayerVersionArn, yang terlihat sepertiarn:aws:lambda:us-east-1:123456789012:layer:python-numpy-layer:1. Untuk memverifikasi bahwa lapisan Anda berfungsi seperti yang diharapkan, gunakan fungsi Lambda di function-numpy direktori.