Terapkan TypeScript kode transpiled di Lambda dengan arsip file.zip

Inisialisasi aplikasi menggunakan TypeScript template Hello World.

sam init --app-template hello-world-typescript --name sam-app --package-type Zip --runtime nodejs24.x

(Opsional) Aplikasi sampel mencakup konfigurasi untuk alat yang umum digunakan, seperti ESLLint untuk linting kode dan J est untuk pengujian unit. Untuk menjalankan perintah lint dan test:

cd sam-app/hello-world
npm install
npm run lint
npm run test

Bangun aplikasi.

cd sam-app
sam build

Terapkan aplikasi.

sam deploy --guided

Ikuti petunjuk di layar. Untuk menerima opsi default yang disediakan dalam pengalaman interaktif, respons dengan Enter.

Output menunjukkan titik akhir untuk REST API. Buka titik akhir di browser untuk menguji fungsinya. Anda harus melihat tanggapan ini:

{"message":"hello world"}

Ini adalah titik akhir API publik yang dapat diakses melalui internet. Kami menyarankan Anda menghapus titik akhir setelah pengujian.

sam delete

Buat direktori proyek untuk aplikasi baru Anda.

mkdir hello-world
cd hello-world

Inisialisasi aplikasi.

cdk init app --language typescript

Tambahkan paket @ types/aws -lambda sebagai ketergantungan pengembangan. Paket ini berisi definisi tipe untuk Lambda.

npm install -D @types/aws-lambda

Buka direktori lib. Anda akan melihat file bernama hello- world-stack.ts. Buat dua file baru di direktori ini: hello-world.function.ts dan hello-world.ts.

Buka hello-world.function.ts dan tambahkan kode berikut ke file. Ini adalah kode untuk fungsi Lambda.

import { Context, APIGatewayProxyResult, APIGatewayEvent } from 'aws-lambda';

export const handler = async (event: APIGatewayEvent, context: Context): Promise<APIGatewayProxyResult> => {
    console.log(`Event: ${JSON.stringify(event, null, 2)}`);
    console.log(`Context: ${JSON.stringify(context, null, 2)}`);
    return {
        statusCode: 200,
        body: JSON.stringify({
            message: 'hello world',
        }),
    };
};

Buka hello-world.ts dan tambahkan kode berikut ke file. Ini berisi NodejsFunction konstruk, yang menciptakan fungsi Lambda, dan LambdaRestApi konstruk, yang menciptakan REST API.

import { Construct } from 'constructs';
import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
import { LambdaRestApi } from 'aws-cdk-lib/aws-apigateway';
  
export class HelloWorld extends Construct {
  constructor(scope: Construct, id: string) {
    super(scope, id);
    const helloFunction = new NodejsFunction(this, 'function');
    new LambdaRestApi(this, 'apigw', {
      handler: helloFunction,
    });
  }
}

Konstruk NodejsFunction si mengasumsikan yang berikut secara default:

Anda dapat mengubah perilaku ini dan mengonfigurasi parameter esbuild lainnya. Untuk informasi selengkapnya, lihat Mengonfigurasi esbuild di referensi AWS CDK API.

Buka hello- world-stack.ts. Ini adalah kode yang mendefinisikan AWS CDK tumpukan Anda. Ganti kode dengan yang berikut:

import { Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import { HelloWorld } from './hello-world';
  
export class HelloWorldStack extends Stack {
  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);
    new HelloWorld(this, 'hello-world');
  }
}

dari hello-world direktori yang berisi cdk.json file Anda, gunakan aplikasi Anda.

cdk deploy

Mem AWS CDK bangun dan mengemas fungsi Lambda menggunakan esbuild, dan kemudian menerapkan fungsi tersebut ke runtime Lambda. Output menunjukkan titik akhir untuk REST API. Buka titik akhir di browser untuk menguji fungsinya. Anda harus melihat tanggapan ini:

{"message":"hello world"}

Ini adalah titik akhir API publik yang dapat diakses melalui internet. Kami menyarankan Anda menghapus titik akhir setelah pengujian.

Pada mesin lokal Anda, buat direktori proyek untuk fungsi baru Anda.

Buat Node.js proyek baru dengan npm atau manajer paket pilihan Anda.

npm init

Tambahkan paket @ types/aws -lambda dan esbuild sebagai dependensi pengembangan. @types/aws-lambdaPaket berisi definisi tipe untuk Lambda.

npm install -D @types/aws-lambda esbuild

Buat file baru bernama index.ts. Tambahkan kode berikut ke file baru. Ini adalah kode untuk fungsi Lambda. Fungsi mengembalikan hello world pesan. Fungsi ini tidak membuat sumber daya API Gateway apa pun.

import { Context, APIGatewayProxyResult, APIGatewayEvent } from 'aws-lambda';

export const handler = async (event: APIGatewayEvent, context: Context): Promise<APIGatewayProxyResult> => {
  console.log(`Event: ${JSON.stringify(event, null, 2)}`);
  console.log(`Context: ${JSON.stringify(context, null, 2)}`);
  return {
      statusCode: 200,
      body: JSON.stringify({
          message: 'hello world',
      }),
   };
};

Tambahkan skrip build ke file package.json. Ini mengonfigurasi esbuild untuk membuat paket penerapan.zip secara otomatis. Untuk informasi selengkapnya, lihat Membangun skrip di dokumentasi esbuild.

Bangun paket.

npm run build

Buat fungsi Lambda menggunakan paket penerapan.zip. Ganti teks yang disorot dengan Nama Sumber Daya Amazon (ARN) dari peran eksekusi Anda.

aws lambda create-function --function-name hello-world --runtime "nodejs24.x" --role arn:aws:iam::123456789012:role/lambda-ex --zip-file "fileb://dist/index.zip" --handler index.handler

Jalankan acara pengujian untuk mengonfirmasi bahwa fungsi mengembalikan respons berikut. Jika Anda ingin memanggil fungsi ini menggunakan API Gateway, buat dan konfigurasikan REST API.

{
  "statusCode": 200,
  "body": "{\"message\":\"hello world\"}"
}