トランスパイルされた TypeScript コードを .zip ファイルアーカイブで Lambda にデプロイする

Hello World TypeScript テンプレートを使用してアプリケーションを初期化します。

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

(オプション) サンプルアプリケーションには、コードの linting 用の ESLint やユニットテスト用の Jest など、一般的に使用されるツールの設定が含まれています。lint コマンドとテストコマンドを実行するには、次のコードを使用します。

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

アプリケーションを構築します。

cd sam-app
sam build

アプリケーションをデプロイします。

sam deploy --guided

画面に表示されるプロンプトに従ってください。インタラクティブな形式で提供されるデフォルトオプションを受け入れるには、Enter を押して応答します。

REST API のエンドポイントが出力に表示されます。ブラウザでエンドポイントを開き、関数をテストします。次のレスポンスが表示されます。

{"message":"hello world"}

これは、インターネット経由でアクセス可能なパブリック API エンドポイントです。テスト後にエンドポイントを削除することを推奨します。

sam delete

新しいアプリケーション用のプロジェクトディレクトリを作成します。

mkdir hello-world
cd hello-world

アプリケーションを初期化します。

cdk init app --language typescript

開発環境の依存関係として @types/aws-lambda パッケージを追加します。このパッケージには Lambda の型定義が含まれています。

npm install -D @types/aws-lambda

lib ディレクトリを開きます。hello-world-stack.ts というファイルが表示されます。このディレクトリに hello-world.function.ts と hello-world.ts の 2 つの新しいファイルを作成します。

hello-world.function.ts を開き、次のコードをファイルに追加します。これは 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',
        }),
    };
};

hello-world.ts を開き、次のコードをファイルに追加します。これには、Lambda 関数を作成するNodejsFunction コンストラクト と、REST API を作成するLambdaRestApi コンストラクト が含まれます。

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,
    });
  }
}

NodejsFunction コンストラクトでは、デフォルトで次のことを前提としています。

この動作を変更したり、他の esbuild パラメータを設定したりできます。詳細については、「AWS CDK API リファレンス」の「Configuring esbuild」(esbuild の設定) を参照してください。

hello-world-stack.ts を開きます。これは、AWS CDK スタックを定義するコードです。このコードを、次のコードで置き換えます。

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');
  }
}

cdk.json ファイルが含まれる hello-world ディレクトリから、アプリケーションをデプロイします。

cdk deploy

AWS CDK は、esbuild を使用して Lambda 関数をビルドおよびパッケージ化し、その関数を Lambda ランタイムにデプロイします。REST API のエンドポイントが出力に表示されます。ブラウザでエンドポイントを開き、関数をテストします。次のレスポンスが表示されます。

{"message":"hello world"}

これは、インターネット経由でアクセス可能なパブリック API エンドポイントです。テスト後にエンドポイントを削除することを推奨します。

ローカルマシンで、新しい関数のプロジェクトディレクトリを作成します。

npm または任意のパッケージマネージャーを使用して、新しい Node.js プロジェクトを作成します。

npm init

@types/aws-lambda および esbuild のパッケージを開発環境の依存関係として追加します。@types/aws-lambda パッケージには Lambda の型定義が含まれています。

npm install -D @types/aws-lambda esbuild

index.ts という名前の新しいファイルを作成します。次のコードを新しいファイルに追加します。これは Lambda 関数のコードです。関数は hello world のメッセージを返します。関数は、API Gateway リソースを作成しません。

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',
      }),
   };
};

ビルドスクリプトを package.json ファイルに追加します。これにより、esbuild が.zip デプロイパッケージを自動的に作成するように設定されます。詳細については、esbuild ドキュメントの「Build scripts」(ビルドスクリプト) を参照してください。

パッケージをビルドします。

npm run build

.zip デプロイパッケージを使用して Lambda 関数を作成します。ハイライト表示されたテキストを、実行ロールの Amazon リソースネーム (ARN) で置き換えます。

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

テストイベントを実行して、関数が次のレスポンスを返すことを確認します。API Gateway を使用してこの関数を呼び出す場合は、REST API を作成および設定してください。

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