ddegagne/aws-lambda

Amazon Web Services (AWS) Lambda Python Docker镜像

https://github.com/degagne/docker-aws-lambda/actions/workflows/docker-ci.yml/badge.svg](https://github.com/degagne/docker-aws-lambda/actions/workflows/docker-ci.yml)

镜像概述

本项目提供用于运行基于Python的AWS Lambda函数的Docker镜像，包含Dockerfile和docker-compose.yaml配置，用于构建和管理基于Python 3.10+的AWS Lambda容器化环境。镜像基于Alpine Linux，提供标准和精简（slim）版本，确保容器轻量高效。

核心功能和特性

• Python 3.10+运行时：专为使用Python 3.10+的AWS Lambda函数定制
• Alpine Linux基础：采用Alpine Linux，实现最小镜像体积和增强安全性
• 自定义CA证书：支持添加自定义CA证书，确保安全通信
• Lambda运行时接口模拟器：内置AWS Lambda Runtime Interface Emulator，支持本地测试
• 多阶段构建：通过多阶段Docker构建优化镜像大小和依赖管理
• 非Root用户运行：以非Root用户运行容器，提升安全性
• Docker Compose支持：提供docker-compose.yaml文件，便于服务的快速设置和管理

镜像标记

Docker镜像标签格式如下：

<image_name>-<python_version>alpine<distro_version>-<variant>

参数说明：

• <image_name>：镜像名称（如 aws-lambda）
• <python_version>：Python版本（如 3.10、3.11）
• <distro_version>：Alpine Linux版本（如 3.22、3.23）
• <variant>：镜像变体（如 slim、standard，标准版本可省略）

标签示例：

• aws-lambda-3.10-alpine3.22-slim
• aws-lambda-3.11-alpine3.22
• aws-lambda-3.13-alpine3.21

支持的标签及Dockerfile链接

• Python 3.13

  • https://github.com/degagne/docker-aws-lambda/tree/main/3.13/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.13/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.13/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.13/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.13/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.13/Dockerfile.slim

• Python 3.12

  • https://github.com/degagne/docker-aws-lambda/tree/main/3.12/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.12/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.12/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.12/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.12/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.12/Dockerfile.slim

• Python 3.11

  • https://github.com/degagne/docker-aws-lambda/tree/main/3.11/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.11/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.11/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.11/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.11/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.11/Dockerfile.slim

• Python 3.10

  • https://github.com/degagne/docker-aws-lambda/tree/main/3.10/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.10/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.10/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.10/Dockerfile.slim
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.10/Dockerfile
  • https://github.com/degagne/docker-aws-lambda/tree/main/3.10/Dockerfile.slim

镜像变体

基础镜像基于Alpine Linux构建，支持多个Python版本。标准版本默认包含以下数据库连接第三方库：

• PyMySQL（MySQL支持）
• psycopg2-binary（PostgreSQL支持）
• oracledb（Oracle支持）

每个Python版本均提供"精简（slim）"变体，优化镜像体积，不包含上述数据库库，适用于无需数据库连接的应用场景。

使用场景

• AWS Lambda函数本地开发与测试
• 构建轻量级Lambda容器镜像
• 需要自定义CA证书的安全通信场景
• 多环境一致的Lambda运行环境管理

使用方法

构建镜像

可通过提供的Dockerfile构建镜像，或从Docker仓库拉取（如可用）。

单镜像构建

进入包含Dockerfile的目录，执行：

bash
docker build -t <image_name>:<tag> .

批量构建（Docker Compose）

使用项目根目录的docker-compose.yaml批量构建所有镜像：

bash
docker compose --project-directory 3.13 --env-file base.env --no-cache build

生成AWS Lambda镜像

创建自定义Dockerfile生成Lambda镜像，以下是Python 3.13 + Alpine 3.22的示例：

dockerfile
FROM python-alpine AS final-image

# 设置Lambda用户、组和任务根目录构建参数
ARG LAMBDA_USER
ARG LAMBDA_GROUP
ARG LAMBDA_TASK_ROOT

# 切换到非Root用户以增强安全性
USER ${LAMBDA_USER}

# 创建Lambda任务根目录
WORKDIR ${LAMBDA_TASK_ROOT}


# 复制函数代码和依赖文件
COPY lambda_function.py ${LAMBDA_TASK_ROOT}
COPY requirements.txt ${LAMBDA_TASK_ROOT}

# 安装Python依赖
RUN pip install --target ${LAMBDA_TASK_ROOT} --requirement requirements.txt --upgrade

# 设置Lambda函数入口点
ENTRYPOINT ["/var/task/lambda-entrypoint.sh"]

# 设置Lambda函数处理程序命令
CMD ["lambda_function.lambda_handler"]

添加自定义CA证书

如需添加自定义CA证书，在final-image阶段前添加以下构建步骤：

dockerfile
# ------------------- 阶段1：构建阶段 -------------------
FROM ddegagne/aws-lambda:3.13-alpine3.22 AS python-alpine

# 切换到Root用户安装证书
USER root

# 下载CA证书并添加到可信证书库
ADD https://artifactory.example.com/artifactory/dcs-container-release-local/CA-Certs/ca-certificate.crt \
    /usr/local/share/ca-certificates/ca-certificates.crt

# 更新CA证书
RUN update-ca-certificates

构建镜像命令

bash
docker build \
  --build-arg LAMBDA_TASK_ROOT=/var/task \
  --build-arg LAMBDA_USER=lambda-user \
  --build-arg LAMBDA_GROUP=lambda-group \
  -f Dockerfile \
  -t aws_docker_test/python3.13:local .

运行镜像

bash
docker run -p 9000:8080 aws_docker_test/python3.13:local

测试Lambda函数

使用AWS Lambda Runtime Interface Emulator本地测试，发送POST请求：

powershell
Invoke-WebRequest -Uri "http://localhost:9000/2015-03-31/functions/function/invocations" -Method Post -ContentType "application/json" -Body '{}'

示例响应：

powershell
StatusCode        : 200
StatusDescription : OK
Content           : {"statusCode": 200, "body": "Hello from Lambda! nice_shtern"}
RawContent        : HTTP/1.1 200 OK
                    Content-Length: 61
                    Content-Type: text/plain; charset=utf-8
                    Date: Thu, 21 Aug 2025 14:28:06 GMT

                    {"statusCode": 200, "body": "Hello from Lambda! nice_shtern"}
Forms             : {}
Headers           : {[Content-Length, 61], [Content-Type, text/plain; charset=utf-8], [Date, Thu, 21 Aug 2025 14:28:06 GMT]}
Images            : {}
InputFields       : {}
Links             : {}
ParsedHtml        : mshtml.HTMLDocumentClass
RawContentLength  : 61