使用 .zip 或 JAR 文件归档部署 Java Lambda 函数

您的 Amazon Lambda 函数代码由脚本或编译的程序及其依赖项组成。您可以使用部署程序包将函数代码部署到 Lambda。Lambda 支持两种类型的部署程序包：容器镜像和 .zip 文件归档。

本页将介绍如何将部署程序包创建为 .zip 文件或 Jar 文件，然后使用该部署程序包通过 Amazon Lambda (Amazon Command Line Interface) 将函数代码部署到 Amazon CLI。

先决条件

Amazon CLI 是一种开源工具，让您能够在命令行 Shell 中使用命令与 Amazon 服务进行交互。要完成本节中的步骤，您必须拥有 Amazon CLI 版本 2。

工具和库

Amazon 提供以下适用于 Java 函数的库。这些库可通过 Maven 中央存储库获得。

将这些库添加到您的构建定义中，如下所示：

要创建部署程序包，请将函数代码和依赖项编译成单个 .zip 文件或 Java 存档 (JAR) 文件。对于 Gradle，请使用 Zip 构建类型。对于 Apache Maven，请使用 Maven Shade 插件。要上传部署包，请使用 Lambda 控制台、Lambda API 或 Amazon Serverless Application Model（Amazon SAM）。

使用 Gradle 构建部署程序包

要创建包含 Gradle 中函数代码和依赖项的部署包，请使用 Zip 构建类型。这是来自完整示例 build.gradle 文件的示例：

task buildZip(type: Zip) {
    into('lib') {
        from(jar)
        from(configurations.runtimeClasspath)
    }
}

此构建配置在 build/distributions 目录中生成部署程序包。在 into('lib') 语句中，jar 任务将包含主类的 jar 归档组装到名为 lib 的文件夹中。此外，configurations.runtimeClassPath 任务将依赖项库从构建的类路径复制到同一 lib 文件夹中。

dependencies {
    ...
    implementation 'com.amazonaws:aws-lambda-java-core:1.2.2'
    implementation 'com.amazonaws:aws-lambda-java-events:3.11.1'
    implementation 'org.apache.logging.log4j:log4j-api:2.17.1'
    implementation 'org.apache.logging.log4j:log4j-core:2.17.1'
    runtimeOnly 'org.apache.logging.log4j:log4j-slf4j18-impl:2.17.1'
    runtimeOnly 'com.amazonaws:aws-lambda-java-log4j2:1.5.1'
    ...
}

Lambda 按 Unicode 字母顺序加载 JAR 文件。如果 lib 目录中的多个 JAR 文件包含相同的类，则使用第一个。可以使用以下 shell 脚本来识别重复类：

mkdir -p expanded
unzip path/to/my/function.zip -d expanded
find ./expanded/lib -name '*.jar' | xargs -n1 zipinfo -1 | grep '.*.class' | sort | uniq -c | sort

为依赖项创建 Java 层

本部分中的说明旨在向您展示如何将依赖项包含在层中。有关如何将依赖项包含在部署包中的说明，请参阅 使用 Gradle 构建部署程序包 或 使用 Maven 构建部署程序包。

当您向函数添加层时，Lambda 会将层内容加载到该执行环境的 /opt 目录中。对于每个 Lambda 运行时系统，PATH 变量都包括 /opt 目录中的特定文件夹路径。为确保 Lambda 能够获取层内容，层 .zip 文件应在以下文件夹路径中具有依赖项：

例如，层.zip 文件结构可能如下所示：

jackson.zip
└ java/lib/jackson-core-2.2.3.jar

此外，Lambda 会自动检测 /opt/lib 目录中的任何库，以及 /opt/bin 目录中的任何二进制文件。为确保 Lambda 正确获取层内容，还可以创建包含以下结构的层：

custom-layer.zip
└ lib
    | lib_1
    | lib_2
└ bin
    | bin_1
    | bin_2

打包层后，请参阅 在 Lambda 中创建和删除层 和 向函数添加层 以完成层设置。

使用 Maven 构建部署程序包

要使用 Maven 构建部署程序包，请使用 Maven Shade 插件。该插件创建一个包含编译的函数代码及其所有依赖项的 JAR 文件。

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>3.2.2</version>
        <configuration>
          <createDependencyReducedPom>false</createDependencyReducedPom>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>shade</goal>
            </goals>
          </execution>
        </executions>
      </plugin>

要构建部署程序包，请使用 mvn package 命令。

[INFO] Scanning for projects...
[INFO] -----------------------< com.example:java-maven >-----------------------
[INFO] Building java-maven-function 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
...
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ java-maven ---
[INFO] Building jar: target/java-maven-1.0-SNAPSHOT.jar
[INFO]
[INFO] --- maven-shade-plugin:3.2.2:shade (default) @ java-maven ---
[INFO] Including com.amazonaws:aws-lambda-java-core:jar:1.2.2 in the shaded jar.
[INFO] Including com.amazonaws:aws-lambda-java-events:jar:3.11.1 in the shaded jar.
[INFO] Including joda-time:joda-time:jar:2.6 in the shaded jar.
[INFO] Including com.google.code.gson:gson:jar:2.8.6 in the shaded jar.
[INFO] Replacing original artifact with shaded artifact.
[INFO] Replacing target/java-maven-1.0-SNAPSHOT.jar with target/java-maven-1.0-SNAPSHOT-shaded.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  8.321 s
[INFO] Finished at: 2020-03-03T09:07:19Z
[INFO] ------------------------------------------------------------------------

此命令在 target 目录中生成 JAR 文件。

如果您使用 Appender 库 (aws-lambda-java-log4j2)，还必须为 Maven Shade 插件配置一个转换器。转换器库合并同时出现在 Appender 库和 Log4j 中的缓存文件的版本。

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>3.2.2</version>
        <configuration>
          <createDependencyReducedPom>false</createDependencyReducedPom>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>shade</goal>
            </goals>
            <configuration>
              <transformers>
                <transformer implementation="com.github.edwgiz.maven_shade_plugin.log4j2_cache_transformer.PluginsCacheFileTransformer">
                </transformer>
              </transformers>
            </configuration>
          </execution>
        </executions>
        <dependencies>
          <dependency>
            <groupId>com.github.edwgiz</groupId>
            <artifactId>maven-shade-plugin.log4j2-cachefile-transformer</artifactId>
            <version>2.13.0</version>
          </dependency>
        </dependencies>
      </plugin>

使用 Lambda 控制台上传部署包

要创建新函数，必须先在控制台中创建该函数，然后上传您的 .zip 或 JAR 文件。要更新现有函数，请打开函数页面，然后按照相同的步骤添加更新的 .zip 或 JAR 文件。

如果您的部署包文件小于 50MB，则可以通过直接从本地计算机上传该文件来创建或更新函数。对于大于 50MB 的 .zip 或 JAR 文件，必须首先将您的程序包上传到 Amazon S3 存储桶。有关如何使用 Amazon Web Services Management Console 将文件上传到 Amazon S3 存储桶的说明，请参阅 Amazon S3 入门。要使用 Amazon CLI 上传文件，请参阅《Amazon CLI 用户指南》中的移动对象。

使用 Amazon CLI 上传部署包

您可以使用 Amazon CLI 创建新函数或使用 .zip 或 JAR 文件更新现有函数。使用 create-function 和 update-function-code 命令部署 .zip 或 JAR 程序包。如果您的文件小于 50MB，则可以从本地生成计算机上的文件位置上传程序包。对于较大的文件，必须从 Amazon S3 存储桶上传 .zip 或 JAR 程序包。有关如何使用 Amazon CLI 将文件上传到 Amazon S3 存储桶的说明，请参阅《Amazon CLI 用户指南》中的移动对象。

要通过 Amazon CLI 使用 .zip 或 JAR 文件创建新函数，则必须指定以下内容：

还必须指定 .zip 或 JAR 文件的位置。如果 .zip 或 JAR 文件位于本地生成计算机上的文件夹中，请使用 --zip-file 选项指定文件路径，如以下示例命令所示。

aws lambda create-function --function-name myFunction \
--runtime java21 --handler example.handler \
--role arn:aws:iam::123456789012:role/service-role/my-lambda-role \
--zip-file fileb://myFunction.zip

要指定 .zip 文件在 Amazon S3 存储桶中的位置，请使用 --code 选项，如以下示例命令所示。您只需对版本控制对象使用 S3ObjectVersion 参数。

aws lambda create-function --function-name myFunction \
--runtime java21 --handler example.handler \
--role arn:aws:iam::123456789012:role/service-role/my-lambda-role \
--code S3Bucket=amzn-s3-demo-bucket,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

要使用 CLI 更新现有函数，请使用 --function-name 参数指定函数的名称。您还必须指定要用于更新函数代码的 .zip 文件的位置。如果 .zip 文件位于本地生成计算机上的文件夹中，请使用 --zip-file 选项指定文件路径，如以下示例命令所示。

aws lambda update-function-code --function-name myFunction \
--zip-file fileb://myFunction.zip

要指定 .zip 文件在 Amazon S3 存储桶中的位置，请使用 --s3-bucket 和 --s3-key 选项，如以下示例命令所示。您只需对版本控制对象使用 --s3-object-version 参数。

aws lambda update-function-code --function-name myFunction \
--s3-bucket amzn-s3-demo-bucket --s3-key myFileName.zip --s3-object-version myObject Version

使用 Amazon SAM 上传部署程序包

您可以使用 Amazon SAM 自动部署函数代码、配置和依赖项。Amazon SAM 是 Amazon CloudFormation 的一个扩展，它提供用于定义无服务器应用程序的简化语法。以下示例模板在 Gradle 使用的 build/distributions 目录中定义了一个包含部署程序包的函数。

AWSTemplateFormatVersion: '2010-09-09'
Transform: 'AWS::Serverless-2016-10-31'
Description: An Amazon Lambda application that calls the Lambda API.
Resources:
  function:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: build/distributions/java-basic.zip
      Handler: example.Handler
      Runtime: java21
      Description: Java function
      MemorySize: 512
      Timeout: 10
      # Function's execution role
      Policies:
        - AWSLambdaBasicExecutionRole
        - AWSLambda_ReadOnlyAccess
        - AWSXrayWriteOnlyAccess
        - AWSLambdaVPCAccessExecutionRole
      Tracing: Active

要创建函数，请使用 package 和 deploy 命令。这些命令是对 Amazon CLI 的自定义。它们包装其他命令以将部署程序包上载到 Amazon S3，使用对象 URI 重写模板，然后更新函数的代码。

以下示例脚本运行 Gradle 构建并上传其创建的部署程序包。它在您第一次运行它时创建一个 Amazon CloudFormation 堆栈。如果堆栈已经存在，脚本会更新它。

#!/bin/bash
set -eo pipefail
aws cloudformation package --template-file template.yml --s3-bucket MY_BUCKET --output-template-file out.yml
aws cloudformation deploy --template-file out.yml --stack-name java-basic --capabilities CAPABILITY_NAMED_IAM

有关完整的工作示例，请参阅以下示例应用程序。