使用 TypeScript Lambda 函数的层

Lambda 层是包含补充代码或数据的 .zip 文件存档。层通常包含库依赖项、自定义运行时系统或配置文件。创建层涉及三个常见步骤：

本主题包含有关如何正确打包并创建具有外部库依赖项的 Node.js Lambda 层的步骤和指南。此外，本主题还说明了如何将层与在 TypeScript 中编写的函数一起使用。

先决条件

要完成本部分中的步骤，您必须满足以下条件：

在本主题中，我们引用了 aws-lambda-developer-guide GitHub 存储库中的 layer-nodejs 示例应用程序。此应用程序包含脚本，脚本会将 lodash 库打包到 Lambda 层中。layer 目录包含用于生成层的脚本。在使用来自层的依赖项的 function-ts 目录中，该应用程序还包含了 TypeScript 示例函数。创建层后，即可转换、部署并调用相应的函数来验证一切是否正常运行。本文档将演示如何使用 TypeScript 示例函数创建、打包、部署并测试该层。

该示例应用程序使用 Node.js 20 运行时。如果您在层中添加其他依赖项，则它们必须与 Node.js 20 兼容。

Node.js 层与 Lambda 运行时环境的兼容性

在 Node.js 层中打包代码时，需要指定与该代码兼容的 Lambda 运行时环境。要评测代码与运行时的兼容性，请考虑代码是为哪些版本的 Node.js、操作系统和指令集架构设计的。

Lambda Node.js 运行时指定其 Node.js 版本和操作系统。在本文档中，您将使用基于 AL2023 的 Node.js 20 运行时。有关运行时版本的更多信息，请参阅支持的运行时。在创建 Lambda 函数时，您可以指定指令集架构。在本文档中，您将使用 arm64 架构。有关 Lambda 中的架构的更多信息，请参阅为 Lambda 函数选择和配置指令集架构。

如果您使用软件包中提供的代码，每个软件包维护者都会独立定义其兼容性。大多数 Node.js 开发都是为了独立于操作系统和指令集架构而设计。此外，打破与新 Node.js 版本的不兼容性的情况并不常见。与评测软件包与 Node.js 版本、操作系统或指令集架构的兼容性相比，应该花更多的时间来评测软件包之间的兼容性。

有时，Node.js 包包含编译后的代码，这需要您考虑操作系统和指令集架构的兼容性。如果您确实需要评测软件包的代码兼容性，则需要检查软件包及其文档。NPM 中的软件包可以通过 package.json 清单文件的 engines、os 和 cpu 字段来指定其兼容性。有关 package.json 文件的更多信息，请参阅 NPM 文档中的 package.json。

Node.js 运行时的层路径

当您向函数添加层时，Lambda 会将层内容加载到执行环境中。如果您的层将依赖项打包到特定的文件夹路径中，Node.js 执行环境将识别这些模块，并且您可以从函数代码中引用这些模块。

为确保您的模块被拾取，请使用以下文件夹路径之一，将它们打包到层 .zip 文件中。这些文件存储在 /opt 中，并将文件夹路径加载到 PATH 环境变量中。

例如，您在本教程中创建生成的层.zip 文件具有以下目录结构：

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

您将把 lodash 库放在 nodejs/node20/node_modules 目录中。这可确保 Lambda 在函数调用期间可以找到该库。

打包层内容

在本示例中，您要将 lodash 库打包在一个层 .zip 文件中。完成以下步骤，安装并打包层内容。

创建层

获取在上一部分中生成的 layer_content.zip 文件，将其作为 Lambda 层上传。您可以使用 AWS Management Console 上传层，也可以通过 AWS Command Line Interface（AWS CLI）使用 Lambda API 上传层。上传层 .zip 文件时，在以下 PublishLayerVersion AWS CLI 命令中，将 nodejs20.x 指定为兼容的运行时系统，并将 arm64 指定为兼容的架构。

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

注意响应中的 LayerVersionArn，与 arn:aws:lambda:us-east-1:123456789012:layer:nodejs-lodash-layer:1 类似。在本教程的下一步中，在将层添加到函数时，您要用到此 Amazon 资源名称（ARN）。

将层添加到函数

部署在函数代码中使用 lodash 库的示例 Lambda 函数，然后附加创建的层。要使用在 TypeScript 中编写的函数代码创建 Lambda 函数，必须将 TypeScript 转换为 JavaScript，以供 Node.js 运行时使用。有关此过程的更多信息，请参阅 定义采用 TypeScript 的 Lambda 函数处理程序。为了提高兼容性，使用层分发依赖项时，请使用 tsc 来转换 TypeScript 模块。如果要捆绑依赖项，请考虑使用 esbuild。有关使用 esbuild 进行捆绑的更多信息，请参阅使用 .zip 文件归档部署在 Lambda 中转换的 TypeScript 代码。

要部署该函数，您需要一个执行角色。有关更多信息，请参阅 使用执行角色定义 Lambda 函数权限。如果目前没有执行角色，则按照可折叠部分中的步骤操作。若有，则跳至下一部分来部署函数。

示例函数代码使用 lodash _.findLastIndex 方法来读取对象数组。它将对象与标准进行比较，以找到匹配项的索引。然后，它会返回 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;
};