使用容器映像部署 Node.js Lambda 函數

您可以透過三種方式為 Node.js Lambda 函數建置容器映像：

使用 Node.js AWS 的基礎映像

AWS 基礎映像會預先載入語言執行期、用來管理 Lambda 與函數程式碼之間互動的執行期界面用戶端，以及用於本機測試的執行期界面模擬器。
使用僅限 AWS 作業系統的基礎映像

AWS 僅限作業系統的基本映像包含 Amazon Linux 發行版本和執行期介面模擬器。這些映像常用於為編譯語言 (如 Go 和 Rust) 和 Lambda 不提供基礎映像的語言或語言版本 (如 Node.js 19) 建置容器映像。您還可以使用僅限作業系統的基礎映像來實作自訂執行期。若要使映像與 Lambda 相容，您必須在映像中加入適用於 Node.js 的執行期介面用戶端。
使用非AWS 基礎映像

您可以使用其他容器登錄檔中的替代基礎映像 (例如 Alpine Linux 或 Debian)。您也可以使用組織建立的自訂映像。若要使映像與 Lambda 相容，您必須在映像中加入適用於 Node.js 的執行期介面用戶端。

提示

若要縮短 Lambda 容器函數變成作用中狀態所需的時間，請參閱 Docker 文件中的使用多階段建置。若要建置有效率的容器映像，請遵循撰寫 Dockerfiles 的最佳實務。

本頁面會說明如何為 Lambda 建置、測試和部署容器映像。

AWS Node.js 的基礎映像

AWS 為 Node.js 提供下列基本映像：

標籤	執行期	作業系統	Dockerfile	棄用
20	Node.js 20	Amazon Linux 2023	Node.js 20 on 的 Dockerfile GitHub	未排程
18	Node.js 18	Amazon Linux 2	上的 Node.js 18 Dockerfile GitHub	2025 年 7 月 31 日

Amazon ECR儲存庫：Galiore.ecr.aws/lambda/nodejs

Node.js 20 和更新版本的基礎映像是以 Amazon Linux 2023 最小容器映像為基礎。先前的基本映像使用 Amazon Linux 2。AL2023 提供與 Amazon Linux 2 不同的優點，包括較小的部署足跡和更新的程式庫版本，例如 glibc。

AL2以 023 為基礎的映像使用 microdnf（以表示dnf）作為套件管理員而非 yum，這是 Amazon Linux 2 中的預設套件管理員。 microdnf 是的獨立實作dnf。如需包含在 AL2023 型映像中的套件清單，請參閱 Amazon Linux 2023 容器映像上安裝之比較套件中的最小容器欄。 https://docs.aws.amazon.com/linux/al2023/ug/al2023-container-image-types.html如需 AL2023 與 Amazon Linux 2 之間差異的詳細資訊，請參閱運算部落格上的 AWS 介紹的 Amazon Linux 2023 執行時間 AWS Lambda。

注意

若要在本機執行以 AL2023 為基礎的映像，包括搭配 AWS Serverless Application Model （AWS SAM），您必須使用 Docker 20.10.10 版或更新版本。

使用 Node.js AWS 的基礎映像

若要完成本節中的步驟，您必須執行下列各項：

AWS Command Line Interface （AWS CLI）第 2 版
Docker （Node.js 20 及更新版本基本映像的最低版本 20.10.10）
Node.js

從 Node.js AWS 的基礎映像建立容器映像

建立專案的目錄，然後切換至該目錄。
```
mkdir example
cd example
```
使用 npm 建立新 Node.js 專案。若要接受互動體驗中提供的預設選項，請按下 Enter。
```
npm init
```

建立稱為 index.js 的新檔案。您可以將下列範例函數程式碼新增至檔案進行測試，或使用您自己的函數程式碼。

範例 CommonJS 處理常式


exports.handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda!'),
    };
    return response;
};

如果您的函數取決於以外的程式庫 AWS SDK for JavaScript，請使用 npm 將它們新增至套件。
建立包含下列組態的新 Dockerfile。
- 將 FROM 屬性設定為URI基本映像的。
- 使用 COPY命令將函數程式碼和執行期相依性複製到 {LAMBDA_TASK_ROOT}，這是 Lambda 定義的環境變數。
- 將 CMD 引數設定為 Lambda 函數處理常式。
請注意，範例 Dockerfile 不包含USER指令。當您將容器映像部署至 Lambda 時，Lambda 會自動定義具有最低權限許可的預設 Linux 使用者。這與標準 Docker 行為不同，其會在未提供USER指示時預設為root使用者。
範例 Dockerfile
```
FROM public.ecr.aws/lambda/nodejs:20

# Copy function code
COPY index.js ${LAMBDA_TASK_ROOT}
  
# Set the CMD to your handler (could also be done as a parameter override outside of the Dockerfile)
CMD [ "index.handler" ]
```
使用 docker build 命令建立 Docker 映像檔。以下範例將映像命名為 docker-image 並為其提供 test 標籤。
```
docker build --platform linux/amd64 -t docker-image:test .
```
注意
此命令會指定 --platform linux/amd64 選項，確保無論建置機器的架構為何，您的容器都與 Lambda 執行環境相容。如果您打算使用ARM64指示集架構建立 Lambda 函數，請務必將命令變更為使用 --platform linux/arm64選項。

使用 docker run 命令啟動 Docker 影像。在此範例中，docker-image 為映像名稱，test 為標籤。
```
docker run --platform linux/amd64 -p 9000:8080 --read-only docker-image:test
```
此命令將映像作為容器執行，並在 localhost:9000/2015-03-31/functions/function/invocations 建立本機端點。

注意
如果您為ARM64指令集架構建置 Docker 映像，請務必使用 --platform linux/arm64選項，而非 --platform linux/amd64。
從新的終端機視窗，將事件張貼至本機端點。
Linux/macOS
在 Linux 或 macOS 中，執行下列 curl 命令：
```
curl "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'
```
此命令會透過空白事件調用函數，並傳回一個回應。如果您使用的是自己的函數程式碼，而不是範例函數程式碼，您可能想要使用JSON承載叫用函數。範例：
```
curl "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"hello world!"}'
```
PowerShell
在中 PowerShell，執行下列Invoke-WebRequest命令：
```
Invoke-WebRequest -Uri "http://localhost:9000/2015-03-31/functions/function/invocations" -Method Post -Body '{}' -ContentType "application/json"
```
此命令會透過空白事件調用函數，並傳回一個回應。如果您使用的是自己的函數程式碼，而不是範例函數程式碼，您可能想要使用JSON承載叫用函數。範例：
```
Invoke-WebRequest -Uri "http://localhost:9000/2015-03-31/functions/function/invocations" -Method Post -Body '{"payload":"hello world!"}' -ContentType "application/json"
```
取得容器 ID。
```
docker ps
```
使用 docker kill 命令停止容器。在此命令中，將 3766c4ab331c 替換為上一步驟中的容器 ID。
```
docker kill 3766c4ab331c
```

將映像上傳至 Amazon ECR並建立 Lambda 函數

執行 get-login-password命令以驗證 Docker CLI與您的 Amazon ECR登錄檔的身分。
- 將 --region 值設定為您要 AWS 區域在其中建立 Amazon ECR儲存庫的。
- 111122223333 以您的 AWS 帳戶 ID 取代。
```
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-1.amazonaws.com
```

ECR 使用 create-repository 命令在 Amazon 中建立儲存庫。


aws ecr create-repository --repository-name hello-world --region us-east-1 --image-scanning-configuration scanOnPush=true --image-tag-mutability MUTABLE

注意

Amazon ECR儲存庫必須與 Lambda 函數 AWS 區域位於相同位置。

如果成功，您將會看到以下回應：


{
    "repository": {
        "repositoryArn": "arn:aws:ecr:us-east-1:111122223333:repository/hello-world",
        "registryId": "111122223333",
        "repositoryName": "hello-world",
        "repositoryUri": "111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world",
        "createdAt": "2023-03-09T10:39:01+00:00",
        "imageTagMutability": "MUTABLE",
        "imageScanningConfiguration": {
            "scanOnPush": true
        },
        "encryptionConfiguration": {
            "encryptionType": "AES256"
        }
    }
}

從上一步驟的輸出中複製 repositoryUri。
執行 docker 標籤命令，將本機映像標記為最新版本的 Amazon ECR儲存庫。在此命令中：
- docker-image:test 是 Docker 映像的名稱和標籤。這是您在docker build命令中指定的映像名稱和標籤。
- 將 <ECRrepositoryUri> 替換為複製的 repositoryUri。請務必:latest在結尾包含 URI。
```
docker tag docker-image:test <ECRrepositoryUri>:latest
```
範例：
```
docker tag docker-image:test 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest
```
執行 docker push 命令，將本機映像部署到 Amazon ECR儲存庫。請務必在儲存庫的:latest結尾包含 URI。
```
docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest
```
建立函數的執行角色 (若您還沒有的話)。在下一個步驟中，您需要角色的 Amazon Resource Name （ARN）。
建立 Lambda 函數。針對 ImageUri，指定URI先前儲存庫。請務必:latest在結尾包含 URI。
```
aws lambda create-function \
  --function-name hello-world \
  --package-type Image \
  --code ImageUri=111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest \
  --role arn:aws:iam::111122223333:role/lambda-ex
```
注意
只要映像與 Lambda 函數位於相同的區域中，您就可以使用不同 AWS 帳戶中的影像建立函數。如需詳細資訊，請參閱 Amazon ECR跨帳戶許可。

調用函數。


aws lambda invoke --function-name hello-world response.json

您應該看到如下回應：


{
  "ExecutedVersion": "$LATEST", 
  "StatusCode": 200
}

若要查看函數的輸出，請檢查 response.json 檔案。

若要更新函數程式碼，您必須再次建置映像、將新映像上傳至 Amazon ECR儲存庫，然後使用 update-function-code命令將映像部署至 Lambda 函數。

Lambda 會將影像標籤解析為特定影像摘要。這表示，如果您指向用於將函數部署到 Amazon 中新映像的映像標籤ECR，Lambda 不會自動更新函數以使用新映像。

若要將新映像部署至相同的 Lambda 函數，您必須使用 update-function-code命令，即使 Amazon 中的映像標籤ECR保持不變。在下列範例中， --publish選項會使用更新後的容器映像建立新的函數版本。


aws lambda update-function-code \
  --function-name hello-world \
  --image-uri 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest \
  --publish

透過執行期介面用戶端使用替代基礎映像

如果您使用僅限作業系統的基礎映像或替代的基礎映像，則必須在映像中加入執行期介面用戶端。執行期介面用戶端會讓您擴充 API針對自訂執行階段使用 Lambda 執行階段，管理 Lambda 與函數程式碼之間的互動。

使用 npm 套件管理員安裝 Node.js 執行期界面用戶端：


npm install aws-lambda-ric

您也可以從下載 Node.js 執行期介面用戶端 GitHub。執行期介面用戶端支援下列 NodeJS 版本：

14.x
16.x
18.x
20.x

下列範例示範如何使用非AWS 基礎映像建置 Node.js 的容器映像。範例 Dockerfile 使用 buster 基礎映像。Dockerfile 包含執行期界面用戶端。

若要完成本節中的步驟，您必須執行下列各項：

AWS Command Line Interface （AWS CLI）第 2 版
Docker
Node.js

從非AWS 基礎映像建立容器映像

建立專案的目錄，然後切換至該目錄。
```
mkdir example
cd example
```
使用 npm 建立新 Node.js 專案。若要接受互動體驗中提供的預設選項，請按下 Enter。
```
npm init
```

建立稱為 index.js 的新檔案。您可以將下列範例函數程式碼新增至檔案進行測試，或使用您自己的函數程式碼。

範例 CommonJS 處理常式


exports.handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda!'),
    };
    return response;
};

建立新的 Dockerfile。下列 Dockerfile 使用 buster 基礎映像，而非 AWS 基礎映像。Dockerfile 包含執行期介面用戶端，可讓映像與 Lambda 相容。Dockerfile 使用多階段建置。第一階段會建立組建映像，這是安裝函數相依項的標準 Node.js 環境。第二階段會建立更細微的映像，包含函數程式碼及其相依項。這會減少最終映像的大小。

將 FROM 屬性設為基礎映像識別符。
使用 COPY 命令複製函數程式碼和執行期相依項。
將 ENTRYPOINT 設為您希望 Docker 容器在啟動時執行的模組。在此案例中，模組是執行期界面用戶端。
將 CMD 引數設定為 Lambda 函數處理常式。

請注意，範例 Dockerfile 不包含USER指令。當您將容器映像部署至 Lambda 時，Lambda 會自動定義具有最低權限許可的預設 Linux 使用者。這與標準 Docker 行為不同，其會在未提供USER指示時預設為root使用者。

範例 Dockerfile


# Define custom function directory
ARG FUNCTION_DIR="/function"

FROM node:20-buster as build-image

# Include global arg in this stage of the build
ARG FUNCTION_DIR

# Install build dependencies
RUN apt-get update && \
    apt-get install -y \
    g++ \
    make \
    cmake \
    unzip \
    libcurl4-openssl-dev

# Copy function code
RUN mkdir -p ${FUNCTION_DIR}
COPY . ${FUNCTION_DIR}

WORKDIR ${FUNCTION_DIR}

# Install Node.js dependencies
RUN npm install

# Install the runtime interface client
RUN npm install aws-lambda-ric

# Grab a fresh slim copy of the image to reduce the final size
FROM node:20-buster-slim

# Required for Node runtimes which use npm@8.6.0+ because
# by default npm writes logs under /home/.npm and Lambda fs is read-only
ENV NPM_CONFIG_CACHE=/tmp/.npm

# Include global arg in this stage of the build
ARG FUNCTION_DIR

# Set working directory to function root directory
WORKDIR ${FUNCTION_DIR}

# Copy in the built dependencies
COPY --from=build-image ${FUNCTION_DIR} ${FUNCTION_DIR}

# Set runtime interface client as default command for the container runtime
ENTRYPOINT ["/usr/local/bin/npx", "aws-lambda-ric"]
# Pass the name of the function handler as an argument to the runtime
CMD ["index.handler"]

使用 docker build 命令建立 Docker 映像檔。以下範例將映像命名為 docker-image 並為其提供 test 標籤。
```
docker build --platform linux/amd64 -t docker-image:test .
```
注意
此命令會指定 --platform linux/amd64 選項，確保無論建置機器的架構為何，您的容器都與 Lambda 執行環境相容。如果您打算使用ARM64指示集架構建立 Lambda 函數，請務必將命令變更為使用 --platform linux/arm64選項。

使用執行期界面模擬器以在本機測試映像。您可以在映像中建置模擬器，或使用下列程序在本機機器上安裝模擬器。

若要在本機電腦上安裝並執行執行期介面模擬器

從專案目錄中，執行下列命令，從本機機器下載執行期介面模擬器（x86-64 架構） GitHub 並將其安裝。

使用 docker run 命令啟動 Docker 影像。注意下列事項：
- docker-image 是映像名稱，而 test 是標籤。
- /usr/local/bin/npx aws-lambda-ric index.handler 是 Dockerfile 中的 ENTRYPOINT，後面接著 CMD。
Linux/macOS
```
docker run --platform linux/amd64 -d -v ~/.aws-lambda-rie:/aws-lambda -p 9000:8080 \
    --entrypoint /aws-lambda/aws-lambda-rie \
    --read-only \
    docker-image:test \
        /usr/local/bin/npx aws-lambda-ric index.handler
```
PowerShell
```
docker run --platform linux/amd64 -d -v "$HOME\.aws-lambda-rie:/aws-lambda" -p 9000:8080 `
--entrypoint /aws-lambda/aws-lambda-rie `
--read-only `
docker-image:test `
    /usr/local/bin/npx aws-lambda-ric index.handler
```
此命令將映像作為容器執行，並在 localhost:9000/2015-03-31/functions/function/invocations 建立本機端點。

注意
如果您為ARM64指令集架構建置 Docker 映像，請務必使用 --platform linux/arm64選項，而非 --platform linux/amd64。
將事件張貼至本機端點。
Linux/macOS
在 Linux 或 macOS 中，執行下列 curl 命令：
```
curl "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'
```
此命令會透過空白事件調用函數，並傳回一個回應。如果您使用的是自己的函數程式碼，而不是範例函數程式碼，您可能想要使用JSON承載叫用函數。範例：
```
curl "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"hello world!"}'
```
PowerShell
在中 PowerShell，執行下列Invoke-WebRequest命令：
```
Invoke-WebRequest -Uri "http://localhost:9000/2015-03-31/functions/function/invocations" -Method Post -Body '{}' -ContentType "application/json"
```
此命令會透過空白事件調用函數，並傳回一個回應。如果您使用的是自己的函數程式碼，而不是範例函數程式碼，您可能想要使用JSON承載叫用函數。範例：
```
Invoke-WebRequest -Uri "http://localhost:9000/2015-03-31/functions/function/invocations" -Method Post -Body '{"payload":"hello world!"}' -ContentType "application/json"
```
取得容器 ID。
```
docker ps
```
使用 docker kill 命令停止容器。在此命令中，將 3766c4ab331c 替換為上一步驟中的容器 ID。
```
docker kill 3766c4ab331c
```

將映像上傳至 Amazon ECR並建立 Lambda 函數

執行 get-login-password命令以驗證 Docker CLI與您的 Amazon ECR登錄檔的身分。
- 將 --region 值設定為您要 AWS 區域在其中建立 Amazon ECR儲存庫的。
- 111122223333 以您的 AWS 帳戶 ID 取代。
```
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-1.amazonaws.com
```

ECR 使用 create-repository 命令在 Amazon 中建立儲存庫。


aws ecr create-repository --repository-name hello-world --region us-east-1 --image-scanning-configuration scanOnPush=true --image-tag-mutability MUTABLE

注意

Amazon ECR儲存庫必須與 Lambda 函數 AWS 區域位於相同位置。

如果成功，您將會看到以下回應：


{
    "repository": {
        "repositoryArn": "arn:aws:ecr:us-east-1:111122223333:repository/hello-world",
        "registryId": "111122223333",
        "repositoryName": "hello-world",
        "repositoryUri": "111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world",
        "createdAt": "2023-03-09T10:39:01+00:00",
        "imageTagMutability": "MUTABLE",
        "imageScanningConfiguration": {
            "scanOnPush": true
        },
        "encryptionConfiguration": {
            "encryptionType": "AES256"
        }
    }
}

從上一步驟的輸出中複製 repositoryUri。
執行 docker 標籤命令，將本機映像標記為最新版本的 Amazon ECR儲存庫。在此命令中：
- docker-image:test 是 Docker 映像的名稱和標籤。這是您在docker build命令中指定的映像名稱和標籤。
- 將 <ECRrepositoryUri> 替換為複製的 repositoryUri。請務必:latest在結尾包含 URI。
```
docker tag docker-image:test <ECRrepositoryUri>:latest
```
範例：
```
docker tag docker-image:test 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest
```
執行 docker push 命令，將本機映像部署到 Amazon ECR儲存庫。請務必在儲存庫的:latest結尾包含 URI。
```
docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest
```
建立函數的執行角色 (若您還沒有的話)。在下一個步驟中，您需要角色的 Amazon Resource Name （ARN）。
建立 Lambda 函數。針對 ImageUri，指定URI先前儲存庫。請務必:latest在結尾包含 URI。
```
aws lambda create-function \
  --function-name hello-world \
  --package-type Image \
  --code ImageUri=111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest \
  --role arn:aws:iam::111122223333:role/lambda-ex
```
注意
只要映像與 Lambda 函數位於相同的區域中，您就可以使用不同 AWS 帳戶中的影像建立函數。如需詳細資訊，請參閱 Amazon ECR跨帳戶許可。

調用函數。


aws lambda invoke --function-name hello-world response.json

您應該看到如下回應：


{
  "ExecutedVersion": "$LATEST", 
  "StatusCode": 200
}

若要查看函數的輸出，請檢查 response.json 檔案。

若要更新函數程式碼，您必須再次建置映像、將新映像上傳至 Amazon ECR儲存庫，然後使用 update-function-code命令將映像部署至 Lambda 函數。

Lambda 會將影像標籤解析為特定影像摘要。這表示，如果您指向用於將函數部署到 Amazon 中新映像的映像標籤ECR，Lambda 不會自動更新函數以使用新映像。


aws lambda update-function-code \
  --function-name hello-world \
  --image-uri 111122223333.dkr.ecr.us-east-1.amazonaws.com/hello-world:latest \
  --publish

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

部署 .zip 封存檔

圖層