Como trabalhar com camadas para funções do Lambda em Java

Uma camada do Lambda é um arquivo .zip que contém código ou dados complementares. As camadas geralmente contêm dependências de biblioteca, um runtime personalizado ou arquivos de configuração. A criação de uma camada envolve três etapas gerais:

Este tópico contém etapas e orientações sobre como empacotar e criar adequadamente uma camada do Lambda em Java com dependências externas de bibliotecas.

Pré-requisitos

Para seguir as etapas desta seção, você deve ter o seguinte:

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

Neste tópico, mencionamos a aplicação de amostra layer-java no repositório awsdocs no GitHub. Essa aplicação contém scripts que baixam as dependências e geram a camada. A aplicação também contém uma função correspondente que usa dependências da camada. Após criar uma camada, você pode implantar e invocar a função correspondente para verificar se tudo funciona corretamente. Como você usa o runtime do Java 21 para as funções, as camadas também devem ser compatíveis com o Java 21.

A amostra de aplicação layer-java contém um único exemplo em dois subdiretórios. O diretório layer contém um arquivo pom.xml que define as dependências da camada, bem como scripts para gerar a camada. O diretório function contém uma amostra de função para ajudar a testar se a camada funciona. Este tutorial explica como criar e empacotar essa camada.

Compatibilidade da camada em Java com o Amazon Linux

A primeira etapa para criar uma camada é agrupar todo o conteúdo da camada em um arquivo .zip. Devido às funções do Lambda serem executadas no Amazon Linux, seu conteúdo da camada deve ser capaz de compilar e criar em um ambiente Linux.

O código Java foi projetado para ser independente da plataforma, de modo que você possa empacotar suas camadas em sua máquina local mesmo que ela não use um ambiente Linux. Após fazer o upload da camada Java para o Lambda, ela ainda será compatível com o Amazon Linux.

Caminhos de camada para runtimes do Java

Quando você adiciona uma camada a uma função, o Lambda carrega o conteúdo da camada no diretório /opt desse ambiente de execução. Para cada runtime do Lambda, a variável PATH já inclui caminhos de pasta específica no diretório /opt. Para garantir que o Lambda colete o conteúdo da camada, o arquivo .zip da camada deve ter suas dependências nos seguintes caminhos de pasta:

Por exemplo, o arquivo .zip de camada resultante que você cria neste tutorial tem a seguinte estrutura de diretórios:

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

O arquivo JAR layer-java-layer-1.0-SNAPSHOT.jar (um uber-jar que contém todas as dependências necessárias) está localizado corretamente no diretório java/lib. Isso garante que o Lambda possa localizar a biblioteca durante as invocações da função.

Empacotar o conteúdo de camada

Neste exemplo, você empacota as duas seguintes bibliotecas Java em um único arquivo JAR:

Conclua as etapas a seguir para instalar e empacotar o conteúdo de camada.

Como criar a camada

Nesta seção, você pega o arquivo layer_content.zip gerado na seção anterior e o carrega como uma camada do Lambda. É possível fazer upload de uma camada usando o AWS Management Console ou a API do Lambda por meio da AWS Command Line Interface (AWS CLI). Ao carregar seu arquivo .zip de camada, no seguinte comando PublishLayerVersion da AWS CLI, especifique java21 como o runtime compatível e arm64 como a arquitetura compatível.

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

Na resposta, anote o LayerVersionArn, que será algo como arn:aws:lambda:us-east-1:123456789012:layer:java-jackson-layer:1. Você precisará desse nome do recurso da Amazon (ARN) na próxima etapa deste tutorial, ao adicionar a camada à função.

Como adicionar a camada à sua função

Nesta seção, você implanta uma amostra de função do Lambda que usa a biblioteca Jackson em seu código de função e, em seguida, você anexa a camada. Para implantar a função, você precisará de um Definir permissões de uma função do Lambda com um perfil de execução. Se ainda não tiver um perfil de execução, siga as etapas na seção recolhível.

O código da função do Lambda recebe um Map<String, String> como entrada e usa a biblioteca Jackson para gravar a entrada como uma string JSON antes de convertê-la em um objeto Java F1Car predefinido. Por fim, a função usa campos do objeto F1Car para estruturar uma string que a função retorna.

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();
    }
}