Uso de capas para funciones de Lambda en Java

Una capa de Lambda es un archivo .zip que contiene código o datos adicionales. Las capas suelen contener dependencias de biblioteca, un tiempo de ejecución personalizado o archivos de configuración. La creación de una capa implica tres pasos generales:

Este tema contiene los pasos y las instrucciones sobre cómo empaquetar y crear correctamente una capa de Lambda en Java con dependencias de bibliotecas externas.

Requisitos previos

Para completar los pasos de esta sección, debe disponer de lo siguiente:

Apache Maven 3.8.6
...
Java version: 21.0.2, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
...

A lo largo de este tema, haremos referencia a la aplicación de muestra layer-java en el repositorio de GitHub awsdocs. Esta aplicación contiene scripts que descargan las dependencias y generan las capas. La aplicación también contiene las funciones correspondientes que utilizan las dependencias de las capas. Tras crear una capa, puede implementar e invocar la función correspondiente para comprobar que todo funciona correctamente. Debido a que utiliza el tiempo de ejecución de Java 21 para las funciones, las capas también deben ser compatibles con Java 21.

La aplicación layer-java de ejemplo contiene un único ejemplo en dos subdirectorios. El directorio layer contiene un archivo pom.xml que define las dependencias de la capa, así como los scripts para generar la capa. El directorio function contiene una función de ejemplo que ayuda a comprobar el funcionamiento de la capa. Este tutorial explica cómo crear y empaquetar esta capa.

Compatibilidad de capas de Java con Amazon Linux

El primer paso para crear una capa consiste en agrupar todo el contenido de la capa en un archivo .zip. Dado que las funciones de Lambda se ejecutan en Amazon Linux, el contenido de la capa debe poder compilarse y crearse en un entorno de Linux.

El código Java está diseñado para ser independiente de la plataforma, por lo que puede empaquetar las capas en su máquina local aunque no utilice un entorno Linux. Tras cargar la capa de Java en Lambda, seguirá siendo compatible con Amazon Linux.

Rutas de capa para tiempos de ejecución de Java

Cuando agrega una capa a una función, Lambda carga el contenido de la capa en el directorio /opt de ese entorno de ejecución. Para cada tiempo de ejecución de Lambda, la variable PATH ya incluye rutas de carpeta específicas en el directorio /opt. Para garantizar que la variable PATH recoja el contenido de la capa, el archivo .zip de la capa debe tener sus dependencias en las siguientes rutas de carpeta:

Por ejemplo, el archivo .zip de capa resultante que cree en este tutorial tiene la siguiente estructura de directorios:

layer_content.zip
└ java
    └ lib
        └ layer-java-layer-1.0-SNAPSHOT.jar

El archivo JAR layer-java-layer-1.0-SNAPSHOT.jar (un uber-jar que contiene todas las dependencias necesarias) está ubicado correctamente en el directorio java/lib. Esto garantiza que Lambda pueda localizar la biblioteca durante las invocaciones de funciones.

Empaquetado del contenido de la capa

En este ejemplo, empaquetará las dos bibliotecas Java siguientes en un único archivo JAR:

Siga los pasos que se indican a continuación para instalar y empaquetar el contenido de la capa.

Creación de la capa

En esta sección, seleccione el archivo layer_content.zip que generó en la sección anterior y cárguelo como una capa de Lambda. Puede cargar una capa mediante la AWS Management Console o la API de Lambda en la AWS Command Line Interface (AWS CLI). Al cargar el archivo .zip de la capa, en el siguiente comando de AWS CLI PublishLayerVersion, especifique java21 como tiempo de ejecución compatible y arm64 como arquitectura compatible.

aws lambda publish-layer-version --layer-name java-jackson-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes java21 \
    --compatible-architectures "arm64"

En la respuesta, anote el LayerVersionArn, que tiene este aspecto: arn:aws:lambda:us-east-1:123456789012:layer:java-jackson-layer:1. Necesitará este nombre de recurso de Amazon (ARN) en el siguiente paso de este tutorial cuando agregue la capa a la función.

Adición de la capa a la función

En esta sección, despliega una función de Lambda de ejemplo que utiliza la biblioteca Jackson en su código de función y a continuación adjunta la capa. Para implementar la función, necesita un Definición de permisos de funciones de Lambda con un rol de ejecución. Si no dispone de un rol de ejecución existente, siga los pasos de la sección desplegable.

El código de la función de Lambda toma un Map<String, String> como entrada y usa Jackson para escribir la entrada como una cadena JSON antes de convertirla en un objeto de Java F1Car predefinido. Por último, la función utiliza los campos del objeto F1Car para crear una cadena que devuelve la función.

package example;

import com.amazonaws.services.lambda.runtime.Context;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;
import java.util.Map;

public class Handler {

    public String handleRequest(Map<String, String> input, Context context) throws IOException {
        // Parse the input JSON
        ObjectMapper objectMapper = new ObjectMapper();
        F1Car f1Car = objectMapper.readValue(objectMapper.writeValueAsString(input), F1Car.class);

        StringBuilder finalString = new StringBuilder();
        finalString.append(f1Car.getDriver());
        finalString.append(" is a driver for team ");
        finalString.append(f1Car.getTeam());
        return finalString.toString();
    }
}