本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 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 Command Line Interface (AWS CLI) 使用 AWS Management Console或 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 Resource Name (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;
};