教程：构建自定义运行时系统

创建执行角色

1. 在 IAM 控制台中，打开 Roles（角色）页面。

2. 选择创建角色。

3. 创建具有以下属性的角色。

   • Trusted entity（可信任的实体）– Lambda。

   • Permissions（权限）– AWSLambdaBasicExecutionRole。

   • Role name（角色名称）– lambda-role。

   AWSLambdaBasicExecutionRole 策略具有函数将日志写入 CloudWatch Logs 所需的权限。

1. 为项目创建一个目录，然后切换到该目录。

   mkdir runtime-tutorial
   cd runtime-tutorial

2. 创建名为 bootstrap 的新文件。这是自定义运行时系统。

   例 bootstrap

   #!/bin/sh
   
   set -euo pipefail
   
   # Initialization - load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

   运行时将从部署程序包加载函数脚本。它使用两个变量来查找脚本。LAMBDA_TASK_ROOT 向它告知在何处提取程序包，_HANDLER 包含脚本的名称。

   在运行时系统加载函数脚本之后，它会使用运行时系统 API 从 Lambda 检索调用事件，并将事件传递到处理程序，然后将响应发送回 Lambda。为了获取请求 ID，运行时会将来自 API 响应的标头保存到临时文件，并从该文件读取 Lambda-Runtime-Aws-Request-Id 标头。

   注意

   运行时还具有其他职责（包括错误处理），并向处理程序提供上下文信息。有关详细信息，请参阅要求。

3. 为函数创建脚本。以下示例脚本将定义一个处理程序函数，该函数将选取事件数据，将该数据记录到 stderr，然后返回它。

   例 function.sh

   function handler () {
     EVENT_DATA=$1
     echo "$EVENT_DATA" 1>&2;
     RESPONSE="Echoing request: '$EVENT_DATA'"
   
     echo $RESPONSE
   }

   runtime-tutorial 目录现在应如下所示：

   runtime-tutorial
   ├ bootstrap
   └ function.sh

4. 使文件可执行并将其添加到 .zip 文件存档。这就是部署包。

   chmod 755 function.sh bootstrap
   zip function.zip function.sh bootstrap

5. 创建名为 bash-runtime 的函数。对于 --role，请输入您的 Lambda 执行角色的 ARN。

   aws lambda create-function --function-name bash-runtime \
   --zip-file fileb://function.zip --handler function.handler --runtime provided.al2023 \
   --role arn:aws:iam::123456789012:role/lambda-role

6. 调用函数。

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   如果使用 cli-binary-format 版本 2，则 Amazon CLI 选项是必需的。要将其设为默认设置，请运行 aws configure set cli-binary-format raw-in-base64-out。有关更多信息，请参阅版本 2 的 Amazon Command Line Interface 用户指南中的 Amazon CLI 支持的全局命令行选项。

   应出现如下响应：

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

7. 验证响应。

   cat response.txt

   应出现如下响应：

   Echoing request: '{"text":"Hello"}'

1. 创建包含 bootstrap 文件的 .zip 文件。

   zip runtime.zip bootstrap

2. 使用 publish-layer-version 命令创建层。

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

   这将创建第一个版本的层。

1. 更新函数配置以拉入到层。

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:1

   这会将运行时添加到 /opt 目录中的函数中。为确保 Lambda 使用层中的运行时系统，您必须从函数的部署包中移除 boostrap，如接下来的两个步骤所示。

2. 创建包含函数代码的 .zip 文件。

   zip function-only.zip function.sh

3. 更新函数代码以仅包含处理程序脚本。

   aws lambda update-function-code --function-name bash-runtime --zip-file fileb://function-only.zip

4. 调用函数以确认它适用于运行时系统层。

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   如果使用 cli-binary-format 版本 2，则 Amazon CLI 选项是必需的。要将其设为默认设置，请运行 aws configure set cli-binary-format raw-in-base64-out。有关更多信息，请参阅版本 2 的 Amazon Command Line Interface 用户指南中的 Amazon CLI 支持的全局命令行选项。

   应出现如下响应：

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

5. 验证响应。

   cat response.txt

   应出现如下响应：

   Echoing request: '{"text":"Hello"}'

1. 要记录有关执行环境的信息，请更新运行时脚本以输出环境变量。

   例 bootstrap

   #!/bin/sh
   
   set -euo pipefail
   
   # Configure runtime to output environment variables
   echo "##  Environment variables:"
   env
   
   # Load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

2. 创建包含新版本 bootstrap 文件的 .zip 文件。

   zip runtime.zip bootstrap

3. 创建新版本的 bash-runtime 层。

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

4. 配置函数以使用新版本的层。

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:2