Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bangunan Node.js Fungsi Peristiwa Lambda dengan esbuild di AWS SAM
Untuk membangun dan mengemas Node.js AWS Lambda Fungsi Acara, Anda dapat menggunakan AWS SAMÂ CLI dengan esbuild JavaScript pengikat. Bundler esbuild mendukung fungsi Lambda yang Anda tulis TypeScript.
Untuk membangun Node.js Fungsi lambda dengan esbuild, tambahkan Metadata bertentangan dengan Anda AWS:Serverless::Function sumber daya dan tentukan esbuild untuk BuildMethod. Saat Anda menjalankan sam build perintah, AWS SAM menggunakan esbuild untuk menggabungkan kode fungsi Lambda Anda.
Anda juga dapat menggabungkan AWS::Serverless::WebFunction dengan esbuild. Isinya EntryPoint file adalah titik masuk, dan titik template yang dibangun EntryPoint pada file yang dibundel. Untuk informasi selengkapnya, lihat Membangun dan menerapkan Lambda Web Functions.
Properti metadata
Yang Metadata objek mendukung properti berikut untuk esbuild.
BuildMethod
Menentukan bundler untuk aplikasi Anda. Satu-satunya nilai yang di-support adalah esbuild.
BuildProperties
Menentukan properti build untuk kode fungsi Lambda Anda.
Yang BuildProperties objek mendukung properti berikut untuk esbuild. Semua properti bersifat opsional. Secara default, AWS SAM menggunakan pengendali fungsi Lambda Anda untuk titik masuk.
- EntryPoints
-
Menentukan titik masuk untuk aplikasi Anda.
- Eksternal
-
Menentukan daftar paket yang akan dihilangkan dari build. Untuk informasi lebih lanjut, lihat Eksternal
di esbuild situs web. - Format
-
Menentukan format output dari yang dihasilkan JavaScript file dalam aplikasi Anda. Untuk informasi lebih lanjut, lihat Format
di Situs esbuild. - Loader
-
Menentukan daftar konfigurasi untuk memuat data untuk jenis file tertentu.
- MainFields
-
Menentukan yang
package.jsonbidang untuk mencoba mengimpor saat menyelesaikan paket. Nilai default-nya adalahmain,module. - Mengecilkan
-
Menentukan apakah akan memperkecil kode keluaran yang dibundel. Nilai default-nya adalah
true. - OutExtension
-
Sesuaikan ekstensi file dari file yang dihasilkan esbuild. Untuk informasi lebih lanjut, lihat Ekstensi keluar
di Situs esbuild. - Peta sumber
-
Menentukan apakah bundler menghasilkan file peta sumber. Nilai default-nya adalah
false.Saat disetel ke
true,NODE_OPTIONS: --enable-source-mapsditambahkan ke variabel lingkungan fungsi Lambda, dan peta sumber dihasilkan dan disertakan dalam fungsi.Atau, ketika
NODE_OPTIONS: --enable-source-mapstermasuk dalam variabel lingkungan fungsi,Sourcemapsecara otomatis diatur ketrue.Ketika bertentangan,
Sourcemap: falselebih diutamakanNODE_OPTIONS: --enable-source-maps.catatanSecara default, Lambda mengenkripsi semua variabel lingkungan yang diam dengan AWS Key Management Service (AWS KMS). Saat menggunakan peta sumber, agar penerapan berhasil, peran eksekusi fungsi Anda harus memiliki izin untuk melakukan
kms:Encrypttindakan. - SourcesContent
-
Menentukan apakah akan menyertakan kode sumber Anda dalam file peta sumber Anda. Konfigurasikan properti ini saat
Sourcemapdiatur ke'true'.-
Tentukan
SourcesContent: 'true'untuk memasukkan semua kode sumber. -
Tentukan
SourcesContent: 'false'untuk mengecualikan semua kode sumber. Ini menghasilkan ukuran file peta sumber yang lebih kecil, yang berguna dalam produksi dengan mengurangi waktu start-up. Namun, kode sumber tidak akan tersedia di debugger.
Nilai default-nya adalah
SourcesContent: true.Untuk informasi lebih lanjut, lihat Sumber konten
di Situs esbuild. -
- Target
-
Menentukan versi target ECMAScript. Nilai default-nya adalah
es2020.
TypeScript Contoh Fungsi Peristiwa Lambda
Contoh berikut AWS SAM cuplikan template menggunakan esbuild untuk membuat Node.js Fungsi lambda dari TypeScript kode di hello-world/app.ts.
Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: CodeUri: hello-world/ Handler: app.handler Runtime: nodejs20.x Architectures: - x86_64 Events: HelloWorld: Type: Api Properties: Path: /hello Method: get Environment: Variables: NODE_OPTIONS: --enable-source-maps Metadata: BuildMethod: esbuild BuildProperties: Format: esm Minify: false OutExtension: - .js=.mjs Target: "es2020" Sourcemap: true EntryPoints: - app.ts External: - "<package-to-exclude>"