Arbeiten mit Ebenen für Java Lambda-Funktionen

Eine Lambda-Ebene ist ein ZIP-Dateiarchiv mit ergänzendem Code oder ergänzenden Daten. Ebenen enthalten üblicherweise Bibliotheksabhängigkeiten, eine benutzerdefinierte Laufzeit oder Konfigurationsdateien. Das Erstellen einer Ebene umfasst drei allgemeine Schritte:

Dieses Thema enthält Schritte und Anleitungen zum ordnungsgemäßen Verpacken und Erstellen einer Java-Lambda-Ebene mit externen Bibliotheksabhängigkeiten.

Voraussetzungen

Um die Schritte in diesem Abschnitt ausführen zu können, müssen Sie über folgende Voraussetzungen verfügen:

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

In diesem Thema verweisen wir auf die layer-java Beispielanwendung imGitHub-Repository awsdocs. Diese Anwendung enthält Skripts, mit denen die Abhängigkeiten heruntergeladen und die Ebene generiert werden. Die Anwendung enthält auch eine entsprechende Funktion, die Abhängigkeiten aus der Ebene verwendet. Nachdem Sie eine Ebene erstellt haben, können Sie die entsprechende Funktion bereitstellen und aufrufen, um zu überprüfen, ob alles ordnungsgemäß funktioniert. Da Sie die Java 21-Laufzeit für die Funktionen verwenden, müssen die Ebenen auch mit Java 21 kompatibel sein.

Die layer-java-Beispielanwendung enthält ein einzelnes Beispiel in zwei Unterverzeichnissen. Das layer-Verzeichnis enthält eine pom.xml-Datei, die die Ebenen-Abhängigkeiten definiert, sowie Skripts zur Generierung der Ebene. Das function-Verzeichnis enthält eine Beispielfunktion, mit deren Hilfe getestet werden kann, ob die Ebene funktioniert. In diesem Tutorial wird beschrieben, wie Sie diese Ebene erstellen und verpacken.

Java-Layer-Kompatibilität mit Amazon Linux

Der erste Schritt beim Erstellen einer Ebene besteht darin, den gesamten Ebeneninhalt in einem ZIP-Dateiarchiv zu bündeln. Da Lambda-Funktionen unter Amazon Linux ausgeführt werden, muss Ihr Ebeneninhalt in einer Linux-Umgebung kompiliert und erstellt werden können.

Java-Code ist so konzipiert, dass er plattformunabhängig ist, sodass Sie Ihre Ebenen auf Ihrem lokalen Computer packen können, auch wenn dieser keine Linux-Umgebung verwendet. Nachdem Sie die Java-Ebene auf Lambda hochgeladen haben, ist sie weiterhin mit Amazon Linux kompatibel.

Ebenenpfade für Java-Laufzeiten

Wenn Sie einer Funktion eine Ebene hinzufügen, lädt Lambda den Ebeneninhalt in das Verzeichnis /opt der Ausführungsumgebung. Für jede Lambda-Laufzeit enthält die Variable PATH bereits spezifische Ordnerpfade innerhalb des Verzeichnisses /opt. Um sicherzustellen, dass die PATH-Variable Ihren Ebeneninhalt aufnimmt, sollte Ihre Ebenen-.zip-Datei ihre Abhängigkeiten in den folgenden Ordnerpfaden haben:

Die resultierende Ebenen-.zip-Datei, die Sie in diesem Tutorial erstellen, hat beispielsweise die folgende Verzeichnisstruktur:

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

Die layer-java-layer-1.0-SNAPSHOT.jar-JAR-Datei (eine uber-jar, die alle unsere erforderlichen Abhängigkeiten enthält) befindet sich korrekt im java/lib-Verzeichnis. Dadurch wird sichergestellt, dass Lambda die Bibliothek bei Funktionsaufrufen finden kann.

Verpacken des Ebeneninhalts

In diesem Beispiel packen Sie die folgenden zwei Java-Bibliotheken in eine einzige JAR-Datei:

Führen Sie die folgenden Schritte aus, um den Ebeneninhalt zu installieren und zu verpacken.

Erstellen der Ebene

In diesem Abschnitt nehmen Sie die layer_content.zip-Datei, die Sie im vorherigen Abschnitt generiert haben und laden sie als Lambda-Ebene hoch. Sie können eine Ebene mit der AWS Management Console oder der Lambda-API über die AWS Command Line Interface (AWS CLI) hochladen. Wenn Sie die .zip-Datei Ihrer Ebene hochladen, geben Sie im folgenden Befehl PublishLayerVersion AWS CLI java21 als kompatible Laufzeit und arm64 als kompatible Architektur an.

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

Notieren Sie sich aus der Antwort den LayerVersionArn, der wie arn:aws:lambda:us-east-1:123456789012:layer:java-jackson-layer:1 aussieht. Sie benötigen diesen Amazon-Ressourcennamen (ARN) im nächsten Schritt dieses Tutorials, wenn Sie die Ebene zu Ihrer Funktion hinzufügen.

Hinzufügen der Ebene zur Funktion

In diesem Abschnitt stellen Sie eine Beispiel-Lambda-Funktion bereit, die die Jackson-Bibliothek in ihrem Funktionscode verwendet und fügen dann die Ebene hinzu. Um die Funktion bereitzustellen, benötigen Sie eine Definieren von Lambda-Funktionsberechtigungen mit einer Ausführungsrolle. Wenn Sie noch keine Ausführungsrolle haben, folgen Sie den Schritten im zusammenklappbaren Abschnitt.

Der Lambda-Funktionscode nimmt ein Map<String, String> als Eingabe auf und verwendet Jackson, um die Eingabe als JSON-String zu schreiben, bevor er sie in ein vordefiniertes Java-Objekt F1Car umwandelt. Schließlich verwendet die Funktion Felder aus dem F1Car-Objekt, um einen String zu erstellen, den die Funktion zurückgibt.

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