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

Terapkan fungsi Node.js Lambda dengan arsip file.zip

Kode AWS Lambda fungsi Anda terdiri dari file.js atau .mjs yang berisi kode handler fungsi Anda, bersama dengan paket dan modul tambahan yang bergantung pada kode Anda. Untuk menerapkan kode fungsi ini ke Lambda, Anda menggunakan paket penerapan. Paket ini dapat berupa arsip file.zip atau gambar kontainer. Untuk informasi selengkapnya tentang menggunakan gambar kontainer dengan Node.js, lihat Menye barkan fungsi Node.js Lambda dengan gambar kontainer.

Untuk membuat paket penerapan sebagai arsip file.zip, Anda dapat menggunakan utilitas arsip file.zip bawaan alat baris perintah Anda, atau utilitas file.zip lainnya seperti 7zip. https://www.7-zip.org/download.html Contoh yang ditunjukkan pada bagian berikut mengasumsikan Anda menggunakan zip alat baris perintah di lingkungan Linux atau macOS. Untuk menggunakan perintah yang sama di Windows, Anda dapat menginstal Windows Subsistem untuk Linux untuk mendapatkan Windows-integrated versi Ubuntu dan Bash.

Perhatikan bahwa Lambda menggunakan izin berkas POSIX, jadi Anda mungkin perlu mengatur izin untuk folder paket penerapan sebelum membuat arsip file.zip.

Dependensi runtime di Node.js

Untuk fungsi Lambda yang menggunakan Node.js runtime, dependensi dapat berupa Node.js modul apa saja. Node.js Runtime mencakup sejumlah pustaka umum, serta versi AWS SDK for JavaScript. Semua Node.js runtime yang didukung termasuk versi 3 dari SDK. Untuk menggunakan SDK versi 2, Anda harus menambahkan SDK ke paket penerapan file.zip Anda. Untuk menemukan versi spesifik SDK yang disertakan dalam runtime yang Anda gunakan, lihatRuntime-included Versi SDK.

Lambda secara berkala memperbarui pustaka SDK dalam Node.js runtime untuk menyertakan fitur terbaru dan peningkatan keamanan. Lambda juga menerapkan patch keamanan dan pembaruan ke pustaka lain yang termasuk dalam runtime. Untuk memiliki kontrol penuh atas dependensi dalam paket Anda, Anda dapat menambahkan versi pilihan Anda dari dependensi yang disertakan runtime ke paket penerapan Anda. Misalnya, jika Anda ingin menggunakan versi SDK tertentu untuk JavaScript, Anda dapat memasukkannya ke dalam file.zip Anda sebagai dependensi. Untuk informasi selengkapnya tentang menambahkan dependensi yang disertakan runtime ke file.zip Anda, lihat. Jalur pencarian ketergantungan dan pustaka yang disertakan runtime

Di bawah model tanggung jawab AWS bersama, Anda bertanggung jawab atas pengelolaan dependensi apa pun dalam paket penerapan fungsi Anda. Ini termasuk menerapkan pembaruan dan patch keamanan. Untuk memperbarui dependensi dalam paket penerapan fungsi Anda, pertama buat file.zip baru dan kemudian unggah ke Lambda. Lihat Membuat paket penyebaran.zip dengan dependensi dan Membuat dan memperbarui fungsi Node.js Lambda menggunakan file.zip untuk informasi lebih lanjut.

Membuat paket penyebaran.zip tanpa dependensi

Jika kode fungsi Anda tidak memiliki dependensi kecuali untuk pustaka yang disertakan dalam runtime Lambda, file.zip Anda hanya berisi index.mjs file index.js or dengan kode handler fungsi Anda. Gunakan utilitas zip pilihan Anda untuk membuat file.zip dengan index.mjs file index.js atau Anda di root. Jika file yang berisi kode handler Anda tidak berada di root file.zip Anda, Lambda tidak akan dapat menjalankan kode Anda.

Untuk mempelajari cara menerapkan file.zip Anda untuk membuat fungsi Lambda baru atau memperbarui fungsi yang sudah ada, lihat. Membuat dan memperbarui fungsi Node.js Lambda menggunakan file.zip

Membuat paket penyebaran.zip dengan dependensi

Jika kode fungsi Anda bergantung pada paket atau modul yang tidak disertakan dalam Node.js runtime Lambda, Anda dapat menambahkan dependensi ini ke file.zip Anda dengan kode fungsi Anda atau menggunakan lapisan Lambda. Petunjuk di bagian ini menunjukkan cara menyertakan dependensi Anda dalam paket penerapan.zip Anda. Untuk petunjuk tentang cara menyertakan dependensi Anda dalam lapisan, lihatMembuat Node.js layer untuk dependensi Anda.

Contoh perintah CLI berikut membuat file.zip bernama my_deployment_package.zip berisi file or index.js dengan kode handler fungsi Anda dan dependensinya. index.mjs Dalam contoh, Anda menginstal dependensi menggunakan manajer paket npm.

Membuat Node.js layer untuk dependensi Anda

Instruksi di bagian ini menunjukkan cara menyertakan dependensi Anda dalam lapisan. Untuk petunjuk tentang cara menyertakan dependensi Anda dalam paket penerapan Anda, lihatMembuat paket penyebaran.zip dengan dependensi. Untuk informasi selengkapnya tentang membuat dan mengelola Node.js lapisan, lihatBekerja dengan lapisan untuk fungsi Lambda Node.js.

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

Misalnya, struktur file .zip layer Anda mungkin terlihat seperti berikut:

xray-sdk.zip
└ nodejs/node_modules/aws-xray-sdk

Selain itu, Lambda secara otomatis mendeteksi pustaka apa pun di /opt/lib direktori, dan binari apa pun di /opt/bin direktori. Untuk memastikan bahwa Lambda menemukan konten layer Anda dengan benar, Anda juga dapat membuat layer dengan struktur berikut:

custom-layer.zip
└ lib
    | lib_1
    | lib_2
└ bin
    | bin_1
    | bin_2

Setelah Anda mengemas layer Anda, lihat Membuat dan menghapus lapisan di Lambda dan sel Menambahkan lapisan ke fungsi esaikan penyiapan lapisan Anda.

Jalur pencarian ketergantungan dan pustaka yang disertakan runtime

Node.js Runtime mencakup sejumlah pustaka umum, serta versi AWS SDK for JavaScript. Jika Anda ingin menggunakan versi lain dari pustaka yang disertakan runtime, Anda dapat melakukannya dengan menggabungkannya dengan fungsi Anda atau dengan menambahkannya sebagai dependensi dalam paket penerapan Anda. Misalnya, Anda dapat menggunakan versi SDK yang berbeda dengan menambahkannya ke paket penerapan.zip Anda. Anda juga dapat memasukkannya ke dalam lapisan Lambda untuk fungsi Anda.

Ketika Anda menggunakan require pernyataan import atau dalam kode Anda, Node.js runtime mencari direktori di NODE_PATH jalur sampai menemukan modul. Secara default, lokasi pertama yang dicari runtime adalah direktori tempat paket penerapan.zip Anda didekompresi dan dipasang ()/var/task. Jika Anda menyertakan versi pustaka yang disertakan runtime dalam paket penerapan Anda, versi ini lebih diutamakan daripada versi yang disertakan dalam runtime. Dependensi dalam paket penerapan Anda juga memiliki prioritas daripada dependensi di lapisan.

Saat Anda menambahkan dependensi ke lapisan, Lambda mengekstrak ini ke /opt/nodejs/nodexx/node_modules tempat nodexx mewakili versi runtime yang Anda gunakan. Di jalur pencarian, direktori ini memiliki prioritas di atas direktori yang berisi pustaka yang disertakan runtime-(). /var/lang/lib/node_modules Oleh karena itu, pustaka di lapisan fungsi memiliki prioritas daripada versi yang disertakan dalam runtime.

Anda dapat melihat jalur pencarian lengkap untuk fungsi Lambda Anda dengan menambahkan baris kode berikut.

console.log(process.env.NODE_PATH)

Anda juga dapat menambahkan dependensi dalam folder terpisah di dalam paket.zip Anda. Misalnya, Anda dapat menambahkan modul kustom ke folder dalam paket.zip yang disebutcommon. Ketika paket.zip Anda didekompresi dan dipasang, folder ini ditempatkan di dalam direktori/var/task. Untuk menggunakan dependensi dari folder dalam paket penerapan.zip dalam kode Anda, gunakan const { } = require() pernyataan import { } from or, tergantung pada apakah Anda menggunakan resolusi modul CJS atau ESM. Contoh:

import { myModule } from './common'

Jika Anda menggabungkan kode Anda denganesbuild,rollup, atau yang serupa, dependensi yang digunakan oleh fungsi Anda dibundel bersama dalam satu atau lebih file. Sebaiknya gunakan metode ini untuk menjual dependensi bila memungkinkan. Dibandingkan dengan menambahkan dependensi ke paket penerapan Anda, menggabungkan kode Anda menghasilkan peningkatan kinerja karena pengurangan I/O operasi.

Membuat dan memperbarui fungsi Node.js Lambda menggunakan file.zip

Setelah membuat paket penerapan.zip, Anda dapat menggunakannya untuk membuat fungsi Lambda baru atau memperbarui yang sudah ada. Anda dapat menerapkan paket.zip Anda menggunakan konsol Lambda, AWS Command Line Interface, dan Lambda API. Anda juga dapat membuat dan memperbarui fungsi Lambda menggunakan AWS Serverless Application Model (AWS SAM) dan CloudFormation.

Ukuran maksimum untuk paket penerapan.zip untuk Lambda adalah 250 MB (unzip). Perhatikan bahwa batas ini berlaku untuk ukuran gabungan semua file yang Anda unggah, termasuk lapisan Lambda apa pun.

Runtime Lambda membutuhkan izin untuk membaca file dalam paket deployment Anda. Dalam notasi oktal izin Linux, Lambda memerlukan 644 izin untuk file yang tidak dapat dieksekusi (rw-r--r--) dan 755 izin (rwxr-xr-x) untuk direktori dan file yang dapat dieksekusi.

Di Linux dan macOS, gunakan chmod perintah untuk mengubah izin file pada file dan direktori dalam paket penerapan Anda. Misalnya, untuk memberikan file yang tidak dapat dieksekusi izin yang benar, jalankan perintah berikut.

chmod 644 <filepath>

Untuk mengubah izin file di Windows, lihat Meng atur, Melihat, Mengubah, atau Menghapus Izin pada Objek dalam dokumentasi Microsoft Windows.

Membuat dan memperbarui fungsi dengan file.zip menggunakan konsol

Untuk membuat fungsi baru, Anda harus terlebih dahulu membuat fungsi di konsol, lalu mengunggah arsip.zip Anda. Untuk memperbarui fungsi yang ada, buka halaman untuk fungsi Anda, lalu ikuti prosedur yang sama untuk menambahkan file.zip yang diperbarui.

Jika file.zip Anda kurang dari 50MB, Anda dapat membuat atau memperbarui fungsi dengan mengunggah file langsung dari mesin lokal Anda. Untuk file.zip yang lebih besar dari 50MB, Anda harus mengunggah paket Anda ke bucket Amazon S3 terlebih dahulu. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan Konsol Manajemen AWS, lihat Memulai dengan Amazon S3. Untuk mengunggah file menggunakan AWS CLI, lihat Memindahkan objek di Panduan AWS CLI Pengguna.

Memperbarui fungsi file.zip menggunakan editor kode konsol

Untuk beberapa fungsi dengan paket penyebaran.zip, Anda dapat menggunakan editor kode bawaan konsol Lambda untuk memperbarui kode fungsi Anda secara langsung. Untuk menggunakan fitur ini, fungsi Anda harus memenuhi kriteria berikut:

Kode fungsi untuk fungsi dengan paket penyebaran gambar kontainer tidak dapat diedit langsung di konsol.

Membuat dan memperbarui fungsi dengan file.zip menggunakan AWS CLI

Anda dapat menggunakan AWS CLI untuk membuat fungsi baru atau memperbarui yang sudah ada menggunakan file.zip. Gunakan perintah create-function dan update-function-code untuk menerapkan paket.zip Anda. Jika file.zip Anda lebih kecil dari 50MB, Anda dapat mengunggah paket.zip dari lokasi file di mesin build lokal Anda. Untuk file yang lebih besar, Anda harus mengunggah paket.zip Anda dari bucket Amazon S3. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan AWS CLI, lihat Mem indahkan objek di Panduan AWS CLI Pengguna.

Untuk membuat fungsi baru menggunakan file.zip dengan AWS CLI, Anda harus menentukan yang berikut:

Anda juga harus menentukan lokasi file.zip Anda. Jika file.zip Anda terletak di folder pada mesin build lokal Anda, gunakan --zip-file opsi untuk menentukan jalur file, seperti yang ditunjukkan pada contoh perintah berikut.

aws lambda create-function --function-name myFunction \
--runtime nodejs24.x --handler index.handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--zip-file fileb://myFunction.zip

Untuk menentukan lokasi file.zip dalam bucket Amazon S3, gunakan --code opsi seperti yang ditunjukkan pada contoh perintah berikut. Anda hanya perlu menggunakan S3ObjectVersion parameter untuk objek berversi.

aws lambda create-function --function-name myFunction \
--runtime nodejs24.x --handler index.handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--code S3Bucket=amzn-s3-demo-bucket,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

Untuk memperbarui fungsi yang ada menggunakan CLI, Anda menentukan nama fungsi Anda menggunakan --function-name parameter. Anda juga harus menentukan lokasi file.zip yang ingin Anda gunakan untuk memperbarui kode fungsi Anda. Jika file.zip Anda terletak di folder pada mesin build lokal Anda, gunakan --zip-file opsi untuk menentukan jalur file, seperti yang ditunjukkan pada contoh perintah berikut.

aws lambda update-function-code --function-name myFunction \
--zip-file fileb://myFunction.zip

Untuk menentukan lokasi file.zip dalam bucket Amazon S3, gunakan --s3-key opsi --s3-bucket dan seperti yang ditunjukkan pada perintah contoh berikut. Anda hanya perlu menggunakan --s3-object-version parameter untuk objek berversi.

aws lambda update-function-code --function-name myFunction \
--s3-bucket amzn-s3-demo-bucket --s3-key myFileName.zip --s3-object-version myObject Version

Membuat dan memperbarui fungsi dengan file.zip menggunakan API Lambda

Untuk membuat dan memperbarui fungsi menggunakan arsip file.zip, gunakan operasi API berikut:

Membuat dan memperbarui fungsi dengan file.zip menggunakan AWS SAM

AWS Serverless Application Model (AWS SAM) adalah toolkit yang membantu merampingkan proses membangun dan menjalankan aplikasi tanpa server. AWS Anda menentukan sumber daya untuk aplikasi Anda dalam templat YAML atau JSON dan menggunakan antarmuka baris AWS SAM perintah (AWS SAM CLI) untuk membangun, mengemas, dan menyebarkan aplikasi Anda. Saat Anda membangun fungsi Lambda dari AWS SAM template, AWS SAM secara otomatis membuat paket penerapan.zip atau image wadah dengan kode fungsi Anda dan dependensi apa pun yang Anda tentukan. Untuk mempelajari selengkapnya tentang menggunakan AWS SAM untuk membangun dan menerapkan fungsi Lambda, lihat Memulai dengan AWS SAM di Panduan Peng AWS Serverless Application Model embang.

Anda juga dapat menggunakan AWS SAM untuk membuat fungsi Lambda menggunakan arsip file.zip yang ada. Untuk membuat fungsi Lambda menggunakan AWS SAM, Anda dapat menyimpan file.zip Anda di bucket Amazon S3 atau di folder lokal di mesin build Anda. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan AWS CLI, lihat Mem indahkan objek di Panduan AWS CLI Pengguna.

Dalam AWS SAM template Anda, AWS::Serverless::Function sumber daya menentukan fungsi Lambda Anda. Di sumber daya ini, atur properti berikut untuk membuat fungsi menggunakan arsip file.zip:

Dengan AWS SAM, jika file.zip Anda lebih besar dari 50MB, Anda tidak perlu mengunggahnya ke bucket Amazon S3 terlebih dahulu. AWS SAM dapat mengunggah paket.zip hingga ukuran maksimum yang diizinkan 250MB (unzip) dari lokasi di mesin build lokal Anda.

Untuk mempelajari selengkapnya tentang menerapkan fungsi menggunakan file.zip di AWS SAM, lihat AWS::Serverless: :Fungsi di Panduan Peng AWS SAM embang.

Membuat dan memperbarui fungsi dengan file.zip menggunakan CloudFormation

Anda dapat menggunakan CloudFormation untuk membuat fungsi Lambda menggunakan arsip file.zip. Untuk membuat fungsi Lambda dari file.zip, Anda harus terlebih dahulu mengunggah file Anda ke bucket Amazon S3. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan AWS CLI, lihat Mem indahkan objek di Panduan AWS CLI Pengguna.

Dalam CloudFormation template Anda, AWS::Lambda::Function sumber daya menentukan fungsi Lambda Anda. Di sumber daya ini, atur properti berikut untuk membuat fungsi menggunakan arsip file.zip:

File.zip yang CloudFormation menghasilkan tidak boleh melebihi 4MB. Untuk mempelajari selengkapnya tentang menerapkan fungsi menggunakan file.zip di CloudFormation, lihat AWS::Lambda: :Fungsi di Panduan Pengguna. CloudFormation