# AWS Lambda TypeScript 集成在 TypeScript 中创建高性能 AWS Lambda 函数并优化冷启动的模式。 ## 概述该技能提供了 AWS Lambda TypeScript 开发的完整模式，涵盖两种主要方法： 1. **NestJS框架** \ - 具有依赖注入、模块化架构和广泛生态系统的全功能框架 2. **Raw TypeScript** \- 具有最大控制力和更小包大小的最小开销方法这两种方法都支持 API 网关和 ALB 与生产就绪配置的集成。 ## 何时使用在以下情况下使用此技能： * 在 TypeScript 中创建新的 Lambda 函数 * 将现有的 TypeScript 应用程序迁移到 Lambda * 优化 TypeScript Lambda 的冷启动性能 * 在基于框架和最小 TypeScript 方法之间进行选择 * 配置API网关或ALB集成 * 为 TypeScript Lambda 设置部署管道 ## 说明 ### 1\.选择你的方法方法|冷启动|捆绑尺寸 |最适合 |复杂性 ---|---|---|---|--- NestJS | < 500 毫秒 |更大 (100KB+) |需要复杂的 API、企业应用程序、DI |中等原始 TypeScript | < 100 毫秒 |较小 (< 50KB) |简单的处理程序、微服务、最少的部门 |低 ### 2\.项目结构 #### NestJS 结构我的-nestjs-lambda/ ├── src/ │ ├── app.module.ts │ ├── main.ts │ ├── lambda.ts # Lambda 入口点 │ └── 模块/ │ └── API/ ├── package.json ├── tsconfig.json └── 无服务器.yml #### 原始 TypeScript 结构我的-ts-lambda/ ├── src/ │ ├── 处理程序/ │ │ └── api.handler.ts │ ├── 服务/ │ └── 实用程序/ ├── dist/ # 编译输出 ├── package.json ├── tsconfig.json └── 模板.yaml ### 3\.实施示例有关详细的实施指南，请参阅参考资料部分。简单示例： **NestJS 处理程序：** // lambda.ts 从'@nestjs/core'导入{NestFactory}；从 '@nestjs/platform-express' 导入 { ExpressAdapter }；从 '@codegenie/serverless-express' 导入 serverlessExpress；从 'aws-lambda' 导入 { Context, Handler }; 从“快递”进口快递；从'./src/app.module'导入{AppModule}；让cachedServer：处理程序；异步函数 bootstrap(): Promise { constexpressApp =express(); const 适配器 = new ExpressAdapter(expressApp); const NestApp =等待NestFactory.create(AppModule, 适配器); 等待 NestApp.init(); 返回 serverlessExpress({ 应用程序：expressApp }); } 导出常量处理程序：处理程序= async（事件：任意，上下文：上下文）=> { 如果（！cachedServer）{ 缓存服务器 = 等待 bootstrap(); } 返回cachedServer（事件，上下文）； }; **原始 TypeScript 处理程序：** // src/handlers/api.handler.ts 从 'aws-lambda' 导入 { APIGatewayProxyEvent, APIGatewayProxyResult, Context }; 导出常量处理程序 = 异步 ( 事件：APIGatewayProxyEvent，上下文：上下文 ): Promise => { 返回{ 状态代码：200， headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ message: '来自 TypeScript Lambda 的问候！' }) }; }; ## 核心概念 ### 冷启动优化 TypeScript 冷启动取决于包大小和初始化代码。关键策略： 1. **延迟加载** \- 推迟大量导入直到需要时 2. **Tree Shaking** \- 从捆绑包中删除未使用的代码 3. **缩小** \- 对较小的包使用 esbuild 或 terser 4. **实例缓存** \- 在调用之间缓存初始化的服务有关详细模式，请参阅 [Raw TypeScript Lambda]()。 ### 连接管理在模块级别创建客户端并重用： // 好：初始化一次，跨调用重用从 '@aws-sdk/client-dynamodb' 导入 { DynamoDBClient }； const dynamoClient = new DynamoDBClient({ 区域: process.env.AWS_REGION }); 导出常量处理程序=异步（事件：APIGatewayProxyEvent）=> { // 使用 dynamoClient - 已经初始化 }; ### 环境配置 // src/config/env.config.ts 导出常量环境 = { 区域：process.env.AWS_REGION || 'us-east-1', 表名：process.env.TABLE_NAME || '', 调试：process.env.DEBUG === 'true', }; // 验证所需的变量 if (!env.tableName) { throw new Error('需要 TABLE_NAME 环境变量'); } ## 最佳实践 ### 内存和超时配置 * **内存** ：NestJS 为 512MB，原始 TypeScript 为 256MB * **超时** ：根据冷启动+预期处理时间设置 * NestJS：冷启动缓冲10-30秒 * 原始 TypeScript：通常 3-10 秒就足够了 ### 依赖关系保持 `package.json` 最小化： { “依赖项”：{ "aws-lambda": "^3.1.0", "@aws-sdk/client-dynamodb": "^3.450.0" }, “开发依赖项”：{ “打字稿”：“^5.3.0”， “esbuild”：“^0.19.0” } } ### 错误处理返回带有结构化错误的正确 HTTP 代码：导出常量处理程序=异步（事件：APIGatewayProxyEvent）：Promise => { 尝试{ const 结果 = 等待 processEvent(事件); 返回{ 状态代码：200， headers: { 'Content-Type': 'application/json' }, 正文：JSON.stringify（结果） }; } 捕获（错误）{ console.error('处理请求时出错：', error); 返回{ 状态代码：500， headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ error: '内部服务器错误' }) }; } }; ### 日志记录使用 CloudWatch Insights 的结构化日志记录： const log = (级别: 字符串, 消息: 字符串, 元?: 对象) => { console.log(JSON.stringify({ 水平，留言，时间戳：new Date().toISOString(), ...元 })); }; log('info', '请求已处理', { requestId: context.awsRequestId }); ## 部署选项 ### 快速入门 **无服务器框架：** 服务：my-typescript-api 提供者：名称：aws 运行时：nodejs20.x 功能：应用程序编程接口：处理程序：dist/handler.handler 事件： - http：路径：/{代理+} 方法：任意 **AWS 萨姆：** AWSTemplateFormat版本：'2010-09-09' 转型：AWS::无服务器-2016-10-31 资源： API功能：类型：AWS::无服务器::函数属性：代码Uri：dist/ 处理程序：handler.handler 运行时：nodejs20.x 活动： API事件：类型： API 属性：路径：/{代理+} 方法：任意有关包括 CI/CD 在内的完整部署配置，请参阅无服务器部署()。 ## 限制和警告 ### Lambda 限制 * **部署包**：解压后最大 250MB（压缩后 50MB） * **内存**：128MB 至 10GB * **超时**：最长 15 分钟 * **并发执行** ：默认 1000（可调整） * **环境变量**：总大小 4KB ### TypeScript 特定注意事项 * **包大小** ：TypeScript 编译为 JavaScript；使用捆绑器来最小化大小 * **冷启动**：Node.js 20.x 提供最佳性能 * **依赖项** ：使用 Lambda 层共享依赖项 * **本机模块**：必须针对 Amazon Linux 2 进行编译 ### 常见陷阱 1. **在模块级别导入重型库** \- 如果不总是需要，则推迟加载 2. **不捆绑依赖项** \- 包含包中的所有生产依赖项 3. **缺少类型定义** \- 安装 `@types/aws-lambda` 以获得正确的事件类型 4. **无超时处理** \- 使用 `context.getRemainingTimeInMillis()` 进行长时间操作 ### 安全考虑 * 切勿对凭证进行硬编码；使用 IAM 角色和环境变量 * **事件数据的输入验证** ：所有传入的事件数据（API网关请求体、S3事件对象、SQS消息体）都是不受信任的外部内容；始终在处理之前进行验证和清理，以防止注入攻击 * **内容清理** ：处理 S3 对象或 SQS 消息负载时，将内容视为不可信的第三方数据；在采取行动之前应用适当的验证、架构检查和清理 * 验证所有输入数据 * 使用最小权限 IAM 策略 * 启用CloudTrail进行审计日志记录 * 清理日志以避免泄露敏感数据 ## 参考文献有关特定主题的详细指导： * **[NestJS Lambda]()** \- 完整的 NestJS 设置、依赖注入、Express/Fastify 适配器 * **[Raw TypeScript Lambda]()** \- 最小处理程序模式、捆绑、摇树 * **[无服务器配置]()** \- 无服务器框架和 SAM 配置 * **[无服务器部署]()** \- CI/CD 管道、环境管理 * **[测试]()** \- 玩笑、集成测试、SAM Local ## 示例 ### 示例 1：创建 NestJS REST API **输入：** 使用 NestJS 为待办事项应用程序创建 TypeScript Lambda REST API **流程：** 1. 使用“nest new”初始化NestJS项目 2. 安装 Lambda 依赖项：`@codegenie/serverless-express`、`aws-lambda` 3. 使用 Express 适配器创建 lambda.ts 入口点 4. 使用 API 网关事件配置 `serverless.yml` 5. 使用无服务器框架进行部署 **输出：** * 完整的NestJS项目结构 * 带有 CRUD 端点的 REST API * DynamoDB 集成 * 部署配置 ### 示例 2：创建原始 TypeScript Lambda **输入：** 创建具有最佳冷启动的最小 TypeScript Lambda 函数 **流程：** 1. 使用 esbuild 设置 TypeScript 项目 2. 使用正确的 AWS 类型创建处理程序 3. 配置最小依赖项 4. 设置 SAM 或无服务器部署 5. 通过 Tree Shaking 优化包大小 **输出：** * 最小 TypeScript Lambda 项目 * 优化包 < 50KB * 冷启动 < 100ms ### 示例 3：使用 GitHub Actions 进行部署 **输入：** 使用 SAM 为 TypeScript Lambda 配置 CI/CD **流程：** 1. 创建 GitHub Actions 工作流程 2.搭建Node.js环境 3. 使用 Jest 运行测试 4. 与 esbuild 捆绑 5. 使用 SAM 进行部署 **输出：** * 完成 `.github/workflows/deploy.yml` * 多级管道 * 集成测试自动化 ## 版本版本：1.0.0

AWS Lambda 打字稿集成

包含技能