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.
Bagian ini menjelaskan cara menambahkan layer ke fungsi Lambda. Untuk informasi konseptual lebih lanjut tentang lapisan dan mengapa Anda mungkin mempertimbangkan untuk menggunakannya, lihatMengelola dependensi Lambda dengan lapisan.
Sebelum Anda dapat mengkonfigurasi fungsi Lambda untuk menggunakan lapisan, Anda harus:
-
Pastikan Anda memiliki izin untuk memanggil versi GetLayerVersionAPIon the layer. Untuk fungsi dalam Anda Akun AWS, Anda harus memiliki izin ini dalam kebijakan pengguna Anda. Untuk menggunakan lapisan di akun lain, pemilik akun tersebut harus memberi akun Anda izin dalam kebijakan berbasis sumber daya. Sebagai contoh, lihat Memberikan akses lapisan Lambda ke akun lain.
Anda dapat menambahkan hingga lima lapisan ke fungsi Lambda. Ukuran total fungsi yang belum di-zip dan semua lapisan tidak dapat melebihi kuota ukuran paket deployment yang belum di-zip sebesar 250 MB. Untuk informasi selengkapnya, lihat Kuota Lambda.
Fungsi Anda dapat terus menggunakan versi lapisan apa pun yang telah Anda tambahkan, bahkan setelah versi lapisan itu dihapus, atau setelah izin Anda untuk mengakses lapisan dicabut. Namun, Anda tidak dapat membuat fungsi baru yang menggunakan versi lapisan yang dihapus.
catatan
Pastikan bahwa layer yang Anda tambahkan ke fungsi kompatibel dengan runtime dan arsitektur set instruksi fungsi.
Untuk menambahkan lapisan ke fungsi (konsol)
Buka halaman Fungsi
di konsol Lambda. -
Pilih fungsi yang akan dikonfigurasi.
-
Di bawah Layers, pilih Add a layer
-
Di bawah Pilih layer, pilih sumber layer:
-
Untuk AWS layer atau sumber layer Custom layer, pilih layer dari menu pull-down. Di bawah Version, pilih versi layer dari menu pull-down.
-
Untuk Tentukan sumber ARN lapisan, masukkan ARN di kotak teks dan pilih Verifikasi. Kemudian, pilih Tambah.
-
Urutan di mana Anda menambahkan lapisan adalah urutan di mana Lambda menggabungkan konten lapisan ke dalam lingkungan eksekusi. Anda dapat mengubah urutan penggabungan lapisan menggunakan konsol.
Untuk memperbarui urutan penggabungan lapisan untuk fungsi Anda (konsol)
Buka halaman Fungsi
di konsol Lambda. -
Pilih fungsi yang akan dikonfigurasi.
-
Di bawah Layers, pilih Edit
-
Pilih salah satu layer.
-
Pilih Merge sebelumnya atau Merge nanti untuk menyesuaikan urutan layer.
-
Pilih Simpan.
Lapisan berversi. Isi dari setiap versi lapisan tidak dapat diubah. Pemilik layer dapat merilis versi layer baru untuk menyediakan konten yang diperbarui. Anda dapat menggunakan konsol untuk memperbarui versi lapisan yang dilampirkan ke fungsi Anda.
Untuk memperbarui versi lapisan untuk fungsi Anda (konsol)
-
Buka halaman Fungsi
di konsol Lambda. -
Pilih layer yang ingin Anda perbarui versinya.
-
Pilih tab Fungsi menggunakan versi ini.
-
Pilih fungsi yang ingin Anda ubah, lalu pilih Edit.
-
Untuk versi Layer, pilih versi layer yang akan diubah.
-
Pilih fungsi Perbarui.
Anda tidak dapat memperbarui versi lapisan fungsi di seluruh AWS akun.
Mengakses konten lapisan dari fungsi Anda
Jika fungsi Lambda Anda menyertakan lapisan, Lambda mengekstrak konten lapisan ke dalam /opt
direktori di lingkungan eksekusi fungsi. Lambda mengekstrak lapisan dalam urutan (rendah ke tinggi) yang terdaftar oleh fungsi. Lambda menggabungkan folder dengan nama yang sama. Jika file yang sama muncul di beberapa lapisan, fungsi menggunakan versi di lapisan yang terakhir diekstrak.
Setiap runtime Lambda menambahkan folder /opt
direktori tertentu ke variabel. PATH
Kode fungsi Anda dapat mengakses konten lapisan tanpa harus menentukan jalur. Untuk informasi selengkapnya tentang pengaturan jalur di lingkungan eksekusi Lambda, lihat Variabel lingkungan runtime yang ditetapkan.
Lihat Jalur lapisan untuk setiap runtime Lambda untuk mempelajari di mana harus menyertakan pustaka Anda saat membuat lapisan.
Jika Anda menggunakan runtime Node.js atau Python, Anda dapat menggunakan editor kode bawaan di konsol Lambda. Anda harus dapat mengimpor pustaka apa pun yang telah Anda tambahkan sebagai lapisan ke fungsi saat ini.
Menemukan informasi lapisan
Untuk menemukan lapisan di akun Anda yang kompatibel dengan runtime fungsi Anda, gunakan file. ListLayersAPI Misalnya, Anda dapat menggunakan perintah list-layers
AWS Command Line Interface (CLI) berikut:
aws lambda list-layers --compatible-runtime python3.9
Anda akan melihat output yang serupa dengan yang berikut:
{
"Layers": [
{
"LayerName": "my-layer",
"LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
"LatestMatchingVersion": {
"LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
"Version": 2,
"Description": "My layer",
"CreatedDate": "2023-11-15T00:37:46.592+0000",
"CompatibleRuntimes": [
"python3.9",
"python3.10",
"python3.11",
]
}
}
]
}
Untuk membuat daftar semua lapisan di akun Anda, hilangkan --compatible-runtime
opsi. Detail respons menunjukkan versi terbaru dari setiap lapisan.
Anda juga bisa mendapatkan versi terbaru dari layer menggunakan file ListLayerVersionsAPI. Misalnya, Anda dapat menggunakan list-layer-versions
CLI perintah berikut:
aws lambda list-layer-versions --layer-name my-layer
Anda akan melihat output yang serupa dengan yang berikut:
{
"LayerVersions": [
{
"LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
"Version": 2,
"Description": "My layer",
"CreatedDate": "2023-11-15T00:37:46.592+0000",
"CompatibleRuntimes": [
"java11"
]
},
{
"LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
"Version": 1,
"Description": "My layer",
"CreatedDate": "2023-11-15T00:27:46.592+0000",
"CompatibleRuntimes": [
"java11"
]
}
]
}