Bekerja dengan lapisan untuk fungsi TypeScript Lambda

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 Node.js dengan dependensi pustaka eksternal dengan benar. Selain itu, topik ini menjelaskan cara menggunakan layer Anda dengan fungsi tertulis TypeScript.

Prasyarat

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

Sepanjang topik ini, kami mereferensikan aplikasi sampel layer-nodejs di repositori. aws-lambda-developer-guide GitHub Aplikasi ini berisi skrip yang akan mengemas pustaka lodash ke dalam lapisan Lambda. layerDirektori berisi skrip untuk menghasilkan lapisan. Aplikasi ini juga berisi fungsi TypeScript sampel dalam function-ts direktori yang menggunakan dependensi dari lapisan. Setelah membuat layer, Anda dapat mentranspile, menyebarkan, dan memanggil fungsi yang sesuai untuk memverifikasi bahwa semuanya berfungsi. Dokumen ini berjalan melalui cara membuat, mengemas, menyebarkan, dan menguji lapisan ini menggunakan fungsi TypeScript sampel.

Contoh aplikasi ini menggunakan runtime Node.js 20. Jika Anda menambahkan dependensi tambahan ke lapisan Anda, mereka harus kompatibel dengan Node.js 20.

Kompatibilitas lapisan Node.js dengan lingkungan runtime Lambda

Saat Anda mengemas kode dalam lapisan Node.js, Anda menentukan lingkungan runtime Lambda yang kompatibel dengan kode tersebut. Untuk menilai kompatibilitas kode dengan runtime, pertimbangkan versi Node.js, sistem operasi apa, dan arsitektur set instruksi apa yang dirancang untuk kode tersebut.

Runtime Lambda Node.js menentukan versi Node.js dan sistem operasi mereka. Dalam dokumen ini, Anda akan menggunakan runtime Node.js 20, yang didasarkan pada AL2 023. Untuk informasi selengkapnya tentang versi runtime, lihatWaktu aktif yang didukung. Saat Anda membuat fungsi Lambda, Anda menentukan arsitektur set instruksi. Dalam dokumen ini, Anda akan menggunakan arm64 arsitektur. Untuk informasi lebih lanjut tentang arsitektur di Lambda, lihat. Memilih dan mengonfigurasi arsitektur set instruksi untuk fungsi Lambda Anda

Bila Anda menggunakan kode yang disediakan dalam sebuah paket, setiap pengelola paket secara independen mendefinisikan kompatibilitasnya. Sebagian besar pengembangan Node.js dirancang untuk bekerja secara independen dari sistem operasi dan arsitektur set instruksi. Selain itu, melanggar ketidakcocokan dengan versi Node.js baru tidak begitu umum. Berharap untuk menghabiskan lebih banyak waktu Anda untuk menilai kompatibilitas antar paket daripada menilai kompatibilitas paket dengan versi Node.js, sistem operasi, atau arsitektur set instruksi.

Terkadang paket Node.js menyertakan kode yang dikompilasi, yang mengharuskan Anda mempertimbangkan kompatibilitas arsitektur sistem operasi dan set instruksi. Jika Anda perlu menilai kompatibilitas kode untuk paket Anda, Anda perlu memeriksa paket dan dokumentasinya. Paket di NPM dapat menentukan kompatibilitasnya melaluiengines,os, dan cpu bidang file package.json manifes mereka. Untuk informasi selengkapnya tentang package.json file, lihat package.json di dokumentasi NPM.

Jalur lapisan untuk runtime Node.js

Saat Anda menambahkan layer ke fungsi, Lambda memuat konten layer ke dalam lingkungan eksekusi. Jika layer Anda mengemas dependensi di jalur folder tertentu, lingkungan eksekusi Node.js akan mengenali modul, dan Anda dapat mereferensikan modul dari kode fungsi Anda.

Untuk memastikan bahwa modul Anda diambil, paketkan ke dalam file layer .zip Anda di salah satu jalur folder berikut. File-file ini disimpan di/opt, dan jalur folder dimuat ke dalam variabel PATH lingkungan.

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

layer_content.zip
└ nodejs
    └ node20
        └ node_modules
            └ lodash
            └ <other potential dependencies>
            └ ...

Anda akan menempatkan lodashperpustakaan di nodejs/node20/node_modules direktori. Ini memastikan bahwa Lambda dapat menemukan pustaka selama pemanggilan fungsi.

Mengemas konten lapisan

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

Membuat layer

Ambil layer_content.zip file yang Anda buat di bagian sebelumnya dan unggah 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 nodejs20.x sebagai runtime yang kompatibel dan arm64 sebagai arsitektur yang kompatibel.

aws lambda publish-layer-version --layer-name nodejs-lodash-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes nodejs20.x \
    --compatible-architectures "arm64"

Dari tanggapan, perhatikanLayerVersionArn, yang terlihat sepertiarn:aws:lambda:us-east-1:123456789012:layer:nodejs-lodash-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

Menyebarkan contoh fungsi Lambda yang menggunakan lodash pustaka dalam kode fungsinya, lalu lampirkan layer yang Anda buat. Untuk membuat fungsi Lambda menggunakan kode fungsi tertulis TypeScript, Anda harus mentranspile TypeScript to JavaScript untuk digunakan oleh runtime Node.js. Untuk informasi lebih lanjut tentang proses ini, lihatTentukan penangan fungsi Lambda di TypeScript. Untuk kompatibilitas yang lebih baik, gunakan tsc untuk mentranspilasi TypeScript modul Anda saat Anda mendistribusikan dependensi Anda dengan lapisan. Jika Anda menggabungkan dependensi Anda, pertimbangkan untuk menggunakan esbuild. Untuk informasi lebih lanjut tentang bundling dengan esbuild, lihat. Terapkan TypeScript kode yang ditranspilasikan di Lambda dengan arsip file.zip

Untuk menerapkan fungsi, Anda memerlukan peran eksekusi. Untuk informasi selengkapnya, lihat Mendefinisikan izin fungsi Lambda dengan peran eksekusi. Jika Anda tidak memiliki peran eksekusi yang ada, ikuti langkah-langkah di bagian yang dapat dilipat. Jika tidak, lewati ke bagian berikutnya untuk menyebarkan fungsi.

Kode fungsi sampel menggunakan _.findLastIndex metode lodash untuk membaca melalui array objek. Ini membandingkan objek dengan kriteria untuk menemukan indeks kecocokan. Kemudian, ia mengembalikan indeks dan nilai objek dalam respons Lambda.

import { Handler } from 'aws-lambda';
import * as _ from 'lodash';

type User = {
  user: string;
  active: boolean;
}

type UserResult = {
  statusCode: number;
  body: string;
}

const users: User[] = [
  { 'user': 'Carlos', 'active': true },
  { 'user': 'Gil-dong', 'active': false },
  { 'user': 'Pat', 'active': false }
];

export const handler: Handler<any, UserResult> = async (): Promise<UserResult> => {

  let out = _.findLastIndex(users, (user: User) => { return user.user == 'Pat'; });
  const response = {
    statusCode: 200,
    body: JSON.stringify(out + ", " + users[out].user),
  };
  return response;
};