appfim/aws-lambda-build-ruby_al2023

AWS Lambda 运行时镜像（基于AL2023，含工具链）

镜像概述

本镜像基于Amazon Linux 2023 (AL2023)构建，是AWS Lambda的专用运行时环境，已预先安装必要的工具链，旨在简化Lambda函数的开发、构建、测试和运行流程。它提供了与AWS Lambda服务兼容的执行环境，确保函数在本地开发与云端部署时的一致性。

核心功能和特性

1. 基于Amazon Linux 2023 (AL2023)

• 遵循AWS Lambda官方推荐的基础操作系统，确保与云端运行环境高度一致
• 包含AL2023的标准系统库和运行时组件，减少环境差异导致的兼容性问题

2. 预装工具链

• 集成Lambda函数开发和构建所需的常用工具链，包括编译器、构建工具、调试工具等
• 无需手动安装依赖，可直接用于构建依赖本地编译的Lambda函数（如含C/C++扩展的Python函数）

3. 与AWS Lambda兼容

• 内置Lambda运行时接口（Runtime Interface Client），支持Lambda函数的本地执行和调试
• 符合Lambda函数的文件系统布局和权限要求，确保本地测试结果与云端执行一致

4. 轻量级与优化

• 基于AL2023的精简配置，镜像体积经过优化，适合快速拉取和部署
• 仅包含运行时必需组件，减少资源占用

使用场景和适用范围

开发与测试

• 本地开发Lambda函数时，提供与云端一致的运行环境，降低"本地工作但云端不工作"的风险
• 支持函数代码的快速迭代和调试，无需频繁部署至AWS进行测试

构建依赖本地编译的函数

• 适用于开发包含本地代码（如C/C++、Rust等）的Lambda函数，预装的工具链可直接用于编译依赖
• 例如：构建使用Python C扩展、Golang编译产物或自定义二进制文件的Lambda函数

CI/CD流程集成

• 可作为CI/CD管道中的构建环境，自动化Lambda函数的编译、打包和测试流程
• 确保构建过程的一致性和可重复性

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 具备AWS账号及Lambda服务访问权限（如需部署函数至AWS）

镜像拉取

通过Docker Hub或AWS ECR拉取镜像（具体镜像标签请参考AWS官方文档）：

bash
docker pull public.ecr.aws/lambda/<runtime>:al2023  # 示例：替换<runtime>为具体运行时（如python3.11、nodejs18等）

基本运行命令

1. 启动交互式容器（用于开发/调试）

bash
docker run -it --rm \
  -v $(pwd):/var/task \  # 挂载本地函数代码目录至容器内Lambda工作目录
  -e AWS_REGION=us-east-1 \  # 可选：设置AWS区域环境变量
  public.ecr.aws/lambda/<runtime>:al2023 \
  bash  # 启动bash交互终端

2. 本地测试Lambda函数

在容器内执行Lambda函数（需确保函数代码符合Lambda handler规范）：

bash
# 在容器内运行（假设handler为index.handler，Node.js示例）
node -e "const handler = require('./index').handler; handler({}, {}, (e,r) => console.log(r))"

环境变量配置

支持Lambda标准环境变量，常用配置包括：

构建和部署示例（Python函数）

1. 准备函数代码（index.py）：

   python
   def handler(event, context):
       return {
           "statusCode": 200,
           "body": "Hello from Lambda (AL2023 runtime)!"
       }
   

2. 使用镜像构建并测试：

   bash
   # 拉取Python 3.11运行时镜像（含工具链）
   docker pull public.ecr.aws/lambda/python:3.11-al2023
   
   # 启动容器并挂载代码
   docker run -it --rm -v $(pwd):/var/task public.ecr.aws/lambda/python:3.11-al2023 bash
   
   # 在容器内测试函数
   python -c "from index import handler; print(handler({}, {}))"
   

3. 部署至AWS Lambda（需安装AWS CLI并配置凭证）：

   bash
   # 构建部署包（如需要）
   zip -r function.zip index.py
   
   # 部署至Lambda（假设已创建函数）
   aws lambda update-function-code --function-name my-function --zip-file fileb://function.zip
   

注意事项

• 镜像标签格式通常为 <runtime>:<version>-al2023，具体请参考AWS Lambda官方镜像文档
• 如需自定义工具链或依赖，可基于本镜像创建Dockerfile进行二次构建
• 本地测试时，部分Lambda服务特性（如触发器、权限策略）需通过AWS SDK或本地模拟工具（如localstack）模拟