基于Ubuntu构建AWS Lambda自定义容器镜像的技术咨询

核心逻辑 #

AWS Lambda自定义镜像的核心要求是镜像能对接Lambda Runtime API，要么内置Runtime Interface Emulator（RIE）用于本地测试，要么直接适配Lambda的运行时调用规范。Ubuntu镜像完全可以通过手动配置满足这些要求。

分步实现与示例 #

1. 选定基础Ubuntu镜像 #

优先选择长期支持版本（如22.04 LTS），确保系统依赖的稳定性和兼容性。

2. 集成Lambda Runtime Interface Emulator（RIE） #

RIE是Lambda提供的用于本地测试镜像的工具，需要将其加入Ubuntu镜像中：

• 获取对应架构（x86_64/arm64）的RIE二进制文件
• 将其复制到镜像的/usr/bin/aws-lambda-rie路径，并赋予执行权限

在Dockerfile中对应命令如下：

# 复制本地下载好的RIE到镜像（替换为你的RIE文件路径）
COPY aws-lambda-rie /usr/bin/aws-lambda-rie
RUN chmod +x /usr/bin/aws-lambda-rie

3. 配置启动入口脚本 #

创建entrypoint.sh脚本，自动判断运行环境（本地测试/Lambda生产环境）并启动对应的运行时：

#!/bin/sh
if [ -z "${AWS_LAMBDA_RUNTIME_API}" ]; then
  # 本地测试时启动RIE
  exec /usr/bin/aws-lambda-rie $LAMBDA_RUNTIME_PATH $@
else
  # Lambda生产环境直接对接Runtime API
  exec $LAMBDA_RUNTIME_PATH $@
fi

替换$LAMBDA_RUNTIME_PATH为你的应用运行时命令，比如Python用/usr/bin/python3 -m awslambdaric，Node.js用node，Go直接用编译后的二进制文件路径。

然后在Dockerfile中添加脚本配置：

COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]
CMD ["your_app.handler"] # 替换为你的Lambda处理程序路径

4. 完整Dockerfile示例（Python应用） #

FROM ubuntu:22.04

# 安装系统依赖与Python环境
RUN apt-get update && apt-get install -y python3 python3-pip \
    && rm -rf /var/lib/apt/lists/* # 清理缓存减小镜像体积

# 安装应用依赖
COPY requirements.txt .
RUN pip3 install --no-cache-dir -r requirements.txt

# 复制应用代码到Lambda默认工作目录
COPY app/ /var/task/

# 添加RIE工具
COPY aws-lambda-rie /usr/bin/aws-lambda-rie
RUN chmod +x /usr/bin/aws-lambda-rie

# 配置启动入口
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

ENTRYPOINT ["/entrypoint.sh"]
CMD ["app.lambda_handler"]

关键注意事项 #

• 架构匹配：确保RIE的架构与你的镜像架构一致，否则会出现运行错误。
• 镜像优化：Ubuntu镜像安装依赖后及时清理apt缓存，避免镜像过大导致部署超时。
• 本地测试：启动容器后通过端口映射测试：

  docker run -p 9000:8080 your-image-tag
  # 用curl触发测试请求
  curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'
  

• 部署流程：将构建好的镜像推送到Amazon ECR，然后在Lambda控制台选择"容器镜像"类型创建函数，配置好内存、超时等参数即可。

内容的提问来源于stack exchange，提问作者Rajeev