amazon/aws-lambda-java

AWS Lambda Java 基础镜像

1. 镜像概述和主要用途

AWS Lambda Java 基础镜像是 AWS 提供的官方基础镜像，包含在 AWS Lambda 上运行容器镜像打包的 Java 函数所需的全部组件。该镜像基于 Amazon Linux 基础操作系统构建，集成了 Java 运行时环境、必要依赖项以及 Lambda Runtime Interface Client (RIC)。RIC 实现了 Lambda https://docs.aws.amazon.com/lambda/latest/dg/runtimes-api.html%EF%BC%8C%E5%85%81%E8%AE%B8%E5%87%BD%E6%95%B0%E8%BF%90%E8%A1%8C%E6%97%B6%E6%8E%A5%E6%94%B6%E5%92%8C%E5%8F%91%E9%80%81%E8%AF%B7%E6%B1%82%E8%87%B3 Lambda 服务。

如需了解镜像的详细组成，可访问 https://github.com/aws/aws-lambda-base-images%E3%80%82

2. 核心功能与特性

• 完整运行时环境：包含 Amazon Linux 基础操作系统和指定版本的 Java 运行时，无需额外配置基础环境。
• Lambda Runtime Interface Client (RIC)：内置 RIC 组件，实现与 Lambda 服务的通信协议，处理请求接收与响应发送。
• 标准化依赖管理：支持将 Java 类文件和依赖 JAR 包分别存放于指定目录，简化依赖管理。
• 本地测试支持：可通过 Docker 命令本地构建和运行镜像，模拟 Lambda 执行环境进行功能测试。
• 与 Lambda 云环境一致性：镜像配置与 AWS Lambda 云端执行环境高度一致，减少部署差异导致的问题。
• 定期安全更新：AWS 会定期提供安全补丁和组件更新，确保镜像安全性。

3. 使用场景与适用范围

• 容器化 Java Lambda 函数：适用于需要将 Java 函数打包为容器镜像部署到 AWS Lambda 的场景。
• 自定义依赖管理：当函数依赖复杂或需要特定版本的 JAR 包时，可通过镜像灵活管理依赖。
• 复杂构建流程：支持与 Gradle、Maven 等构建工具集成，适配自动化构建流程。
• 本地开发与测试：需在本地验证函数逻辑、调试依赖冲突或测试请求处理流程时使用。

4. 使用方法与配置说明

4.1 目录结构要求

函数运行时需遵循以下目录结构：

• 类文件（.class）存放于 /var/task（可通过环境变量 ${LAMBDA_TASK_ROOT} 引用）。
• 依赖 JAR 包存放于 /var/task/lib 目录。

预期目录结构示例：

/var/task/
├── com
│   └── example
│       ├── LambdaHandler.class  # 函数处理类
│       └── <其他类文件>
└── lib
    ├── aws-lambda-java-core-1.2.1.jar  # Lambda 核心依赖
    ├── aws-lambda-java-events-3.7.0.jar  # 事件处理依赖
    └── <其他 JAR 依赖>

4.2 Dockerfile 编写

根据构建工具（Gradle 或 Maven）的不同，Dockerfile 需调整类文件和依赖的复制路径。

4.2.1 Gradle 项目示例

dockerfile
FROM public.ecr.aws/lambda/java:11

# 从 Gradle 构建目录复制类文件和依赖
COPY build/classes/java/main ${LAMBDA_TASK_ROOT}
COPY build/dependency/* ${LAMBDA_TASK_ROOT}/lib/

# 设置函数处理程序（也可通过外部参数覆盖）
CMD [ "com.example.LambdaHandler::handleRequest" ]

4.2.2 Maven 项目示例

dockerfile
FROM public.ecr.aws/lambda/java:11

# 从 Maven 构建目录复制类文件和依赖
COPY target/classes ${LAMBDA_TASK_ROOT}
COPY target/dependency/* ${LAMBDA_TASK_ROOT}/lib/

# 设置函数处理程序（也可通过外部参数覆盖）
CMD [ "com.example.LambdaHandler::handleRequest" ]

4.3 依赖管理配置

4.3.1 Gradle 配置

添加 Gradle 任务以收集运行时依赖：

groovy
task copyRuntimeDependencies(type: Copy) {
    from docker.xuanyuan.run/configurations.runtimeClasspath
    into 'build/dependency'
}

build.dependsOn copyRuntimeDependencies

执行构建后，依赖将被复制到 build/dependency 目录。

4.3.2 Maven 配置

使用 maven-dependency-plugin 收集运行时依赖：

xml
<build>
   <plugins>
     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <version>3.1.2</version>
       <executions>
         <execution>
           <id>copy-dependencies</id>
           <phase>package</phase>
           <goals>
             <goal>copy-dependencies</goal>
           </goals>
         </execution>
       </executions>
     </plugin>
     <!-- 其他插件配置 -->
   </plugins>
</build>

执行以下命令编译并收集依赖：

bash
mvn compile dependency:copy-dependencies -DincludeScope=runtime

依赖将被复制到 target/dependency 目录。

4.4 本地构建与测试

4.4.1 构建镜像

bash
docker build -t <镜像名称> .

4.4.2 运行镜像

bash
docker run -p 9000:8080 <镜像名称>

4.4.3 本地调用函数

在另一个终端中，使用 curl 发送请求：

bash
curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"hello world!"}'

5. 部署指南

如需将镜像部署到 AWS Lambda，需先推送至 Amazon ECR（Elastic Container Registry）：

1. 创建 ECR 仓库：参考 AWS 文档 https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html%E3%80%82
2. 推送镜像至 ECR：参考 AWS 文档 https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html%E3%80%82

6. 维护政策

• 定期更新：AWS 会定期发布包含安全补丁和组件优化的镜像更新。
• 环境一致性：镜像设计与 Lambda 云端执行环境保持一致，但 AWS 可能调整组件或依赖以优化镜像体积和性能。
• 部署兼容性：镜像部署到 Lambda 时将按原样运行，确保本地测试结果与云端执行一致。