View a markdown version of this page

Bangunan Node.js Fungsi Peristiwa Lambda dengan esbuild di AWS SAM - AWS Serverless Application Model

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.json bidang untuk mencoba mengimpor saat menyelesaikan paket. Nilai default-nya adalah main,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-maps ditambahkan ke variabel lingkungan fungsi Lambda, dan peta sumber dihasilkan dan disertakan dalam fungsi.

Atau, ketika NODE_OPTIONS: --enable-source-maps termasuk dalam variabel lingkungan fungsi, Sourcemap secara otomatis diatur ke true.

Ketika bertentangan, Sourcemap: false lebih diutamakan NODE_OPTIONS: --enable-source-maps.

catatan

Secara 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:Encrypt tindakan.

SourcesContent

Menentukan apakah akan menyertakan kode sumber Anda dalam file peta sumber Anda. Konfigurasikan properti ini saat Sourcemap diatur 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>"